Тестирование выплат
В этой статье описано, как проверять выплаты в тестовом режиме ЮKassa. При использовании тестового режима всё проходит, как при настоящих выплатах, но деньги никуда не переводятся.
О тестовом режиме
Тестовый режим доступен сразу после регистрации в личном кабинете ЮKassa — вы можете протестировать выплаты в любой момент, даже до указания данных компании и заключения договора.
Чтобы использовать тестовый режим, нужно зарегистрироваться в личном кабинете ЮKassa и создать тестовый шлюз.
В тестовом режиме доступны все основные возможности API, даже те, которые для настоящего шлюза нужно подключать через менеджера ЮKassa.
Особенности использования тестового режима:
- для аутентификации запросов необходимо использовать идентификатор и секретный ключ тестового шлюза;
- в запросах необходимо передавать специальные тестовые данные (зависят от того, какую функциональность вы проверяете);
- в объектах выплат, созданных для тестового шлюза, параметр
test
принимает значениеtrue
.
Пример тестовой выплаты
JSON
{ "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
).
Тестовый шлюз
Создать тестовый шлюз можно до регистрации в ЮKassa и после.
Если вы не зарегистрированы в ЮKassa
Шаг 1. Зарегистрируйтесь в ЮKassa по этой ссылке.
Шаг 2. В процессе увидите два варианта: продолжить регистрацию или перейти к тестированию платежей. Выберите тестирование. Вам отобразится созданный тестовый личный кабинет.
Шаг 3. В верхнем меню нажмите на блок с названием магазина (в мобильной версии это иконка магазина).

Блок с названием магазина (на компьютере)

Блок с название магазина (на телефоне)
Шаг 4. В открывшемся списке нажмите Добавить тестовый шлюз. Вам отобразится окно создания тестового шлюза.

Окно создания тестового шлюза
Шаг 5. При создании тестового шлюза укажите, что будете использовать новый API, введите необходимые данные и нажмите Добавить. В течение минуты вам отобразится созданный тестовый шлюз.
Если у вас есть личный кабинет ЮKassa
Шаг 1. Перейдите в личный кабинет.
Шаг 2. В верхнем меню нажмите на блок с названием шлюза (в мобильной версии это иконка кошелька)

Блок с названием шлюза (на компьютере)

Блок с иконкой кошелька (на телефоне)
Шаг 3. В открывшемся списке нажмите Добавить тестовый шлюз. Вам отобразится окно создания тестового шлюза.

Окно создания тестового шлюза
Шаг 4. При создании тестового шлюза укажите, что будете использовать новый API, введите необходимые данные и нажмите Добавить. В течение минуты вам отобразится созданный тестовый шлюз.
Тестирование интеграции
Шаг 1. Получите идентификатор и секретный ключ тестового шлюза. Они нужны для аутентификации запросов.
Шаг 2. Выберите ту функциональность, которую хотите протестировать:
- Выплаты на банковские карты
- Выплаты на кошельки ЮMoney
- Использование универсального токена для платежей и выплат
- Запрос баланса выплат и ошибка о недостаточном количестве денег на балансе
Шаг 3. Протестируйте выбранную функциональность по инструкциям.
Проведение настоящих выплат
Если вы успешно всё проверили и хотите начать делать реальные выплаты, убедитесь, что для аутентификации запросов теперь используете данные настоящего, а не тестового шлюза.
Проверьте, что вам подключены все возможности, которые вы хотите использовать: проведите пробные выплаты на минимальную сумму или уточните у менеджера, какие возможности вам доступны. При необходимости согласуйте с менеджером нужные вам опции и дождитесь, когда вам настроят шлюз.
Статья была полезна?
Да
Нет
Что почитать еще