В этой статье описано, как проверять платежи в тестовом режиме ЮKassa.
При использовании тестового режима всё проходит, как при настоящих платежах, но деньги никуда не переводятся.
Тестовый режим доступен сразу после регистрации в личном кабинете ЮKassa — вы можете протестировать платежи в любой момент, даже до указания данных компании и заключения договора.
Чтобы использовать тестовый режим, нужно зарегистрироваться в личном кабинете ЮKassa и создать тестовый магазин.
В тестовом режиме доступны все основные возможности API, даже те, которые для настоящего магазина нужно подключать через менеджера ЮKassa.
Особенности использования тестового режима:
- для аутентификации запросов необходимо использовать идентификатор и секретный ключ тестового магазина;
- в запросах необходимо передавать специальные тестовые данные (зависят от того, какую функциональность вы проверяете);
- в объектах платежей, созданных для тестового магазина, параметр testпринимает значениеtrue.
Пример тестового платежа
{ "id": "23d93cac-000f-5000-8000-126628f15141", "status": "pending", "paid": false, "amount": { "value": "2.00", "currency": "RUB" }, "confirmation": { "type": "redirect", "confirmation_url": "https://yoomoney.ru/api-pages/v2/payment-confirm/epl?orderId=23d93cac-000f-5000-8000-126628f15141" }, "created_at": "2019-01-22T14:30:45.129Z", "description": "Заказ №1", "metadata": {}, "recipient": { "account_id": "100500", "gateway_id": "100700" }, "refundable": false, "test": true }
Вы можете протестировать все возможности API, включая автоплатежи и отправку данных для чеков по 54-ФЗ, для следующих способов оплаты:
- оплата банковской картой:
- на странице ЮKassa;
- с использованием платежного токена (payment_token), полученного с помощью Checkout.js или мобильного SDK;
- на вашей странице (если у вас есть сертификат PCI DSS);
- оплата из кошелька ЮMoney.
Создать тестовый магазин можно до регистрации в ЮKassa и после.
Шаг 1. Зарегистрируйтесь в ЮKassa по этой ссылке.
Шаг 2. В процессе увидите два варианта: продолжить регистрацию или перейти к тестированию платежей.
Выберите тестирование.
Вам отобразится созданный тестовый магазин.
Шаг 1. Перейдите в личный кабинет.
Шаг 2. Нажмите Все магазины и выплаты, затем Добавить магазин.
Шаг 3. Выберите добавление тестового магазина, выберите нужные вам настройки и нажмите Добавить.
Вам отобразится созданный тестовый магазин.
Вы можете создать максимум 5 тестовых магазинов.
Шаг 1. Получите идентификатор и секретный ключ тестового магазина. Они нужны для аутентификации запросов.
Шаг 2. Настройте тестовый магазин:
- При необходимости настройте уведомления в разделе Интеграция — HTTP-уведомления.
- Если используете решение ЮKassa для работы по 54-ФЗ, в разделе Настройки — Онлайн-Касса включите режим проверки чеков.
Шаг 3. Выберите ту функциональность, которую хотите протестировать:
Шаг 4. Протестируйте выбранную функциональность по инструкциям.
Не отдавайте товар, за который заплатили через тестовый магазин. Чтобы избежать накладок, для тестовых
уведомлений от ЮKassa используйте специальный URL (его нужно прописать в настройках тестового магазина в личном кабинете).
Настоящие карты нельзя использовать в тестовом магазине. Вместо них проверяйте оплату с помощью тестовых карт.
Ниже приведены тестовые карты, которые относятся к разным платежным системам — для тестирования выбирайте любую карту. В качестве срока действия укажите любую дату (но больше текущей), CVC и код для прохождения 3-D Secure — любые числа.
При тестировании автоплатежей выбирайте тестовые карты без 3-D Secure, иначе повторный платеж не пройдет.
Вы можете проверить оплату банковскими картами разных платежных систем:
| Номер | Тип карты | 3-D Secure |
|---|---|---|
| 5555555555554477 | Mastercard | ✔️ |
| 5555555555554444 | Mastercard | ➖ |
| 6759649826438453 | Maestro | ➖ |
| 4793128161644804 | Visa | ✔️ |
| 4111111111111111 | Visa | ➖ |
| 4175001000000017 | Visa Electron | ➖ |
| 2200000000000004 | Mir | ✔️ |
| 2202474301322987 | Mir | ➖ |
| 370000000000002 | American Express | ➖ |
| 3528000700000000 | JCB | ➖ |
| 36700102000000 | Diners Club | ➖ |
Если вы хотите проверить значение параметра
cancellation_details
при неуспешных платежах, используйте любые тестовые карты разных платежных систем.| Номер карты | Причина отмены платежа |
|---|---|
| 5555555555554592 (Mastercard) 4839665499603842 (Visa) 2200000000000012 (Mir) | 3d_secure_failed |
| 5555555555554535 (Mastercard) 4926946416239025 (Visa) 2200000000000020 (Mir) | call_issuer |
| 5555555555554543 (Mastercard) 4141435412630840 (Visa) 2200000000000038 (Mir) | card_expired |
| 5555555555554568 (Mastercard) 4483274282299972 (Visa) 2200000000000046 (Mir) | fraud_suspected |
| 5555555555554527 (Mastercard) 4889971706588753 (Visa) 2202202212312379 (Mir) | general_decline |
| 5555555555554600 (Mastercard) 4562265587712390 (Visa) 2200000000000053 (Mir) | insufficient_funds |
| 5555555555554618 (Mastercard) 4951017853630544 (Visa) 2201382000000013 (Mir) | invalid_card_number |
| 5555555555554626 (Mastercard) 4194180666146368 (Visa) 2200770212727079 (Mir) | invalid_csc |
| 5555555555554501 (Mastercard) 4654130848359150 (Visa) 2201382000000021 (Mir) | issuer_unavailable |
| 5555555555554576 (Mastercard) 4565231022577548 (Visa) 2201382000000039 (Mir) | payment_method_limit_exceeded |
| 5555555555554550 (Mastercard) 4233961169071671 (Visa) 2201382000000047 (Mir) | payment_method_restricted |
| Номер карты | Причина отмены платежа |
|---|---|
| 5555555555554584 (Mastercard) 4969751510013864 (Visa) 2201382000000054 (Mir) | country_forbidden |
| 5555555555554634 (Mastercard) 4119098878796485 (Visa) 2201696981989955 (Mir) | fraud_suspected |
Для тестирования оплаты из кошелька ЮMoney тестовый кошелек не понадобится: в тестовом магазине платежи проходят без участия реального кошелька.
Чтобы протестировать оплату, проводите платеж как обычно. При оплате выберите кошелек ЮMoney и на отобразившейся платежной форме нажмите Заплатить. Платеж завершится успешно.
Если вы используете сценарий интеграции Виджет ЮKassa, на платежной форме будет доступна только оплата банковской картой. Кошелек ЮMoney также будет отображаться на платежной форме, но его нельзя использовать для оплаты.
При оплате банковской картой вы можете проверить успешные и неуспешные сценарии, а при оплате из кошелька ЮMoney — только успешные.
Проверьте успешный сценарий сохранения способа оплаты и проведения платежа с использованием сохраненного способа оплаты.
Для тестирования оплаты из кошелька ЮMoney тестовый кошелек не понадобится. При тестировании оплаты с банковской карты используйте тестовые банковские карты без прохождения аутентификации по 3-D Secure, например
5555
5555
5555
4444
(Mastercard).Проверьте неуспешные сценарии на каждом этапе проведения автоплатежей.
Вы можете проверить сценарий, в котором платеж с сохранением способа оплаты не проходит. Например, из-за недостатка денег на карте.
Для этого при проведении платежа для оплаты используйте специальные тестовые банковские карты.
Вы можете проверить сценарий, в котором сохранение способа оплаты успешно, а при повторном платеже оплата не проходит.
Для этого проведите платеж с сохранением способа оплаты с помощью специальной тестовой карты, затем используйте идентификатор сохраненного способа оплаты для повторного платежа. Оплата сохраненным способом не пройдет из-за нехватки денег на карте. В объекте платежа будет указана причина отмены
insufficient_funds
.Для тестирования этого сценария используйте следующие тестовые банковские карты:
- 5555555555554642(Mastercard)
- 4000000000000002(Visa)
- 2200000000000079(Mir)
В тестовом магазине можно проверить проведение оплаты по 54-ФЗ. Взаимодействие с ЮKassa в режиме проверки чеков проходит как при настоящих платежах или возвратах: вам нужно передавать данные для формирования чеков и вы можете просматривать информацию о чеках в личном кабинете.
В режиме проверки чеков ЮKassa только имитирует взаимодействие с онлайн-кассой: тестовые данные не передаются в онлайн-кассу и ОФД, поэтому физический чек не формируется, а пользователь не получает письма от ЮKassa и чеки от ОФД.
Чтобы проверить работу с чеками:
- Настройте тестовый магазин: в личном кабинете перейдите в тестовый магазин, в разделе Настройки — Онлайн-Касса включите режим проверки чеков и выберите сценарий отправки данных.
- Проверьте работу с платежами и возвратами в соответствии с выбранным сценарием.
- Когда соберетесь принимать платежи от ваших реальных пользователей, проверьте, что в вашем настоящем магазине прописаны настройки онлайн-кассы.
Формирование чеков — это часть процесса проведения платежей и возвратов. На каждом этапе проверьте отправку данных для чеков и посмотрите, как чеки отображаются в истории платежей тестового магазина.
При тестировании в запросах передавайте идентификатор и секретный ключ тестового магазина, для оплаты используйте специальные тестовые карты и тестовый кошелек.
Проверьте, что на каждом этапе работы вы формируете нужные чеки в соответствии с выбранным сценарием отправки чеков.
| Этап | Одновременно или Сначала чек | Сначала платеж |
|---|---|---|
| Создание платежа | Чек прихода | Чек прихода |
| Полное подтверждение платежа | Чек не нужен | Чек не нужен |
| Частичное подтверждение платежа | Чек прихода | Чек возврата прихода Чек прихода |
| Отмена платежа | Чек формируется автоматически | Чек возврата прихода |
| Доставка товара после предоплаты | Чек зачета предоплаты | Чек зачета предоплаты |
| Полный возврат | Чек формируется автоматически | Чек возврата прихода |
| Частичный возврат | Чек возврата прихода | Чек возврата прихода |
Проверьте, что вы корректно передаете данные для чеков:
- данные переданы в соответствующем запросе (зависит от сценария отправки чеков);
- переданы все обязательные параметры;
- значения параметров переданы в нужном формате;
- в чеке не более 100 товаров;
- сумма платежа совпадает с общей суммой чека (чтобы определить сумму чека, по каждому товару умножьте quantityнаamountи просуммируйте);
- все суммы в чеке положительные.
Если что-то будет не так, ЮKassa вернет ошибку.
Проверьте, что передаваемые данные соответствуют требованиям 54-ФЗ и ограничениям онлайн-касс:
- параметр exciseтолько у товаров с признаком предмета расчета «Подакцизный товар»;
- для товаров, продаваемых в кредит, создан отдельный чек: нельзя, чтобы в одном чеке были товары с признаком способа расчета «Кредит» и товары с другими признаками способа расчета;
- параметры product_code,country_of_origin_code,customs_declaration_numberтолько у товаров с признаками предмета расчета «Товар», «Подакцизный товар», «Несколько вариантов», «Другое».
Если что-то будет не так, онлайн-касса не сформирует чек — информация об ошибке отобразится в истории платежей (в тестовом магазине будет имитация ответа от онлайн-кассы). Статус платежа будет зависеть от сценария отправки чеков: в сценарии Сначала чек, потом платеж ЮKassa отменит платеж и автоматически сформирует чек возврата прихода; в других сценариях платеж пройдет.
Быстрый стартОсновы проведения платежейНеуспешные платежиОплата по 54-ФЗ