Для тестирования интеграции вам понадобится тестовая интернет-площадка в ЮKassa. При работе с ней всё проходит, как при настоящих платежах и выплатах, но деньги никуда не переводятся.
Тестовый режим доступен сразу после регистрации в личном кабинете — вы можете протестировать Безопасную сделку в любой момент, даже до заключения договора.
В тестовом режиме доступны только два способа оплаты — банковская карта и кошелек ЮMoney. Другие способы оплаты проверить нельзя. Для тестирования нужно использовать специальные тестовые данные.
В тестовом режиме доступны все основные возможности API, даже те, которые для настоящей интернет-площадки нужно подключать через менеджера ЮKassa.
В объектах сделок, платежей и выплат, созданных для тестовой интернет-площадки, параметр
test
принимает значение true
.Пример тестовой сделки
{ "type": "safe_deal", "fee_moment": "payment_succeeded", "id": "dl-285e5ee7-0022-5000-8000-01516a44b147", "balance": { "value": "0.00", "currency": "RUB" }, "payout_balance":{ "value":"0.00", "currency":"RUB" }, "status": "opened", "created_at": "2021-06-18T07:28:39.390497Z", "expires_at": "2021-09-16T07:28:39.390513Z", "metadata": { "order_id": "37" }, "description": "SAFE_DEAL 123554642-2432FF344R", "test": true }
Шаг 1. Создайте тестовую интернет-площадку:
- Перейдите в личный кабинет.
- Нажмите Все магазины и выплаты, затем Добавить интернет-площадку.
- Укажите, что платежи будут получать физические лица, и нажмите Продолжить.
- Выберите добавление тестовой интернет-площадки, укажите, как будете принимать платежи — на сайте или без сайта, и нажмите Добавить. Вам отобразится созданная тестовая интернет-площадка.
Шаг 2. Настройте тестовую интернет-площадку:
- Выпустите секретный ключ для тестовой интернет-площадки в разделе Интеграция — Ключи API.
- Сохраните идентификатор и секретный ключ тестовой интернет-площадки для последующей аутентификации запросов.
- При необходимости настройте уведомления в разделе Интеграция — HTTP-уведомления.
- Если используете решение ЮKassa для работы по 54-ФЗ, в разделе Настройки — Онлайн-Касса включите режим проверки чеков.
Для аутентификации запросов используйте идентификатор и секретный ключ тестовой интернет-площадки.
Проверьте ваш успешный сценарий, например создайте сделку, получите оплату от покупателя и при необходимости отправьте данные для чека, сделайте выплату продавцу. При платежах и выплатах используйте специальные тестовые данные:
| Этап | Тестовые данные |
|---|---|
| Получение оплаты от покупателя | Используйте тестовую банковскую карту, например:
|
| Выплата продавцу | Банковская карта: получите синоним для любой банковской карты (настоящей или тестовой), деньги фактически переводиться не будут. Кошелек ЮMoney: используйте номера тестовых кошельков:
|
Проверьте ваши альтернативные и неуспешные сценарии, например:
- смоделируйте неуспешную оплату с помощью специальных тестовых карт;
- если принимаете платежи в две стадии, подтвердите платеж частично;
- если принимаете платежи в две стадии, отмените платеж;
- сделайте частичный возврат платежа;
- сделайте полный возврат платежа;
- смоделируйте выплату меньше минимального размера, передав некорректную сумму в запросе на создания платежа и в запросе на создание выплаты;
- смоделируйте превышение максимального размера выплаты, передав некорректную сумму;
- если делаете выплаты на кошельки ЮMoney, смоделируйте неуспешную выплату на анонимный кошелек с помощью тестового кошелька 41001614575714.
Проверьте, как отображаются проведенные операции в личном кабинете тестовой интернет-площадки.
Перед проведением сделок с участием реальных пользователей вашей платформы проверьте:
- Для аутентификации запросов вы используете идентификатор и секретный ключ настоящей интернет-площадки.
- Если вы используете решение ЮKassa для работы по 54-ФЗ, вы прописали настройки онлайн-кассы для вашей настоящей интернет-площадки.
- У вас есть доступ ко всем возможностям ЮKassa, которые вы планируете использовать (например, вам разрешено проводить автоплатежи). Если что-то в тестовой интернет-площадке работает, а в настоящей — нет, напишите вашему менеджеру.
Есть вопросы или замечания по документации?
Можем созвониться и обсудить их лично: мы поможем вам разобраться, а вы нам — понять, что тут нужно улучшить.
Для этого оставьте свои контакты и выберите время.
Да, хочу обсудить