В этой статье описано, как проверять выплаты в тестовом режиме ЮKassa. При использовании тестового режима всё проходит, как при настоящих выплатах, но деньги никуда не переводятся.
Тестовый режим доступен сразу после регистрации в личном кабинете ЮKassa — вы можете протестировать выплаты в любой момент, даже до заключения договора.
Чтобы использовать тестовый режим, нужно создать в личном кабинете тестовый шлюз.
В тестовом режиме доступны все основные возможности API, даже те, которые для настоящего шлюза нужно подключать через менеджера ЮKassa.
Особенности использования тестового режима:
- для аутентификации запросов необходимо использовать идентификатор и секретный ключ тестового шлюза;
- в запросах необходимо передавать специальные тестовые данные (зависят от того, какую функциональность вы проверяете);
- в объектах выплат, созданных для тестового шлюза, параметр testпринимает значениеtrue.
Пример тестовой выплаты
{ "id": "po-285ec15d-0003-5000-a000-08d1bec7dade", "amount": { "value": "2.00", "currency": "RUB" }, "status": "succeeded", "payout_destination": { "type": "yoo_money", "account_number": "4100116075156746" }, "description": "Выплата по заказу № 37", "created_at": "21.06.2021T14:28:45.132Z", "metadata": { "order_id": "37" }, "test": "test" }
В тестовом режиме можно проверить только выплаты обычным физическим лицам.
Вы можете проверить эти возможности API ЮKassa:
- Выплаты на банковские карты
- Выплаты на кошельки ЮMoney
- Использование универсального токена для платежей и выплат
- Запрос баланса выплат
Можно протестировать:
- успешное проведение выплат;
- обработку некоторых лимитов выплат;
- обработку некоторых неуспешных сценариев с отменой выплаты (обработка значений объекта cancellation_details).
Шаг 1. Если у вас нет тестового шлюза, создайте его:
- Перейдите в личный кабинет.
- Нажмите Все магазины и выплаты, затем Добавить шлюз.
- Выберите добавление тестового шлюза и нажмите Добавить. Вам отобразится созданный тестовый шлюз с префиксом test_.
Шаг 2. Получите идентификатор и секретный ключ тестового шлюза.
Шаг 3. Выберите ту функциональность, которую хотите протестировать:
- Выплаты на банковские карты
- Выплаты на кошельки ЮMoney
- Использование универсального токена для платежей и выплат
- Запрос баланса выплат и ошибка о недостаточном количестве денег на балансе
Шаг 4. Протестируйте выбранную функциональность по инструкциям.
Если вы успешно всё проверили и хотите начать делать реальные выплаты, убедитесь, что для аутентификации запросов теперь используете данные настоящего, а не тестового шлюза.
Проверьте, что вам подключены все возможности, которые вы хотите использовать: проведите пробные выплаты на минимальную сумму или уточните у менеджера, какие возможности вам доступны. При необходимости согласуйте с менеджером нужные вам опции и дождитесь, когда вам настроят шлюз.
Неуспешные выплатыОсновы работы с APIСправочник APIКоды ответа (состояния) HTTP