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