Вы можете протестировать все возможности API ЮKassa при оплате банковской картой и из кошелька ЮMoney, включая отправку данных для формирования чеков.
Вы можете проверить свою интеграцию в тестовом магазине, прежде чем начнете принимать реальные платежи. При оплате в тестовом магазине все проходит, как при настоящих платежах, но деньги никуда не переводятся.
Для тестирования создайте тестовый магазин и настройте его: укажите URL для получения HTTP-уведомлений, получите в личном кабинете идентификатор и секретный ключ с префиксом test_. Используйте полученные данные для аутентификации запросов в API.
Вы можете создать максимум 5 тестовых магазинов. Подробнее о тестовом магазине и его настройке
Не отдавайте товар, за который заплатили через тестовый магазин. Чтобы избежать накладок, для тестовых
уведомлений от ЮKassa используйте специальный URL (его нужно прописать в настройках тестового магазина в личном кабинете).
Вы можете протестировать все возможности API, включая отправку данных для чеков, для следующих способов оплаты:
- оплата банковской картой:
- на странице ЮKassa;
- с использованием платежного токена (payment_token), полученного с помощью Checkout.js или мобильного SDK;
- на вашей странице (если у вас есть сертификат PCI DSS);
- оплата из кошелька ЮMoney.
Настоящие карты нельзя использовать в тестовом магазине. Вместо них проверяйте оплату с помощью тестовых карт.
Ниже приведены тестовые карты, которые относятся к разным платежным системам — для тестирования выбирайте любую карту. В качестве срока действия укажите любую дату (но больше текущей), CVC и код для прохождения 3-D Secure — любые числа.
Вы можете проверить оплату банковскими картами разных платежных систем:
| Номер | Тип карты |
|---|---|
| 5555555555554477 | Mastercard (с 3-D Secure) |
| 5555555555554444 | Mastercard |
| 6759649826438453 | Maestro |
| 4793128161644804 | Visa (с 3-D Secure) |
| 4111111111111111 | Visa |
| 4175001000000017 | Visa Electron |
| 2200000000000004 | Mir (с 3-D Secure) |
| 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.
В тестовом магазине можно проверить проведение оплаты по 54-ФЗ. Взаимодействие с ЮKassa в режиме проверки чеков проходит как при настоящих платежах или возвратах: вам нужно передавать данные для формирования чеков и вы можете просматривать информацию о чеках в личном кабинете.
В режиме проверки чеков ЮKassa только имитирует взаимодействие с онлайн-кассой: тестовые данные не передаются в онлайн-кассу и ОФД, поэтому физический чек не формируется, а пользователь не получает письма от ЮKassa и чеки от ОФД.
Чтобы проверить работу с чеками:
- Настройте тестовый магазин: в личном кабинете перейдите в тестовый магазин, в разделе Настройки — Онлайн-Касса включите режим проверки чеков и выберите сценарий отправки данных.
- Проверьте работу с платежами и возвратами в соответствии с выбранным сценарием.
- Когда соберетесь принимать платежи от ваших реальных пользователей, проверьте, что в вашем настоящем магазине прописаны настройки онлайн-кассы.
Формирование чеков — это часть процесса проведения платежей и возвратов. На каждом этапе проверьте отправку данных для чеков и посмотрите, как чеки отображаются в истории платежей тестового магазина.
При тестировании в запросах передавайте идентификатор и секретный ключ тестового магазина, для оплаты используйте специальные тестовые карты и тестовый кошелек.
Проверьте, что на каждом этапе работы вы формируете нужные чеки в соответствии с выбранным сценарием отправки чеков.
| Этап | Одновременно или Сначала чек | Сначала платеж |
|---|---|---|
| Создание платежа | Чек прихода | Чек прихода |
| Полное подтверждение платежа | Чек не нужен | Чек не нужен |
| Частичное подтверждение платежа | Чек прихода | Чек возврата прихода Чек прихода |
| Отмена платежа | Чек формируется автоматически | Чек возврата прихода |
| Доставка товара после предоплаты | Чек зачета предоплаты | Чек зачета предоплаты |
| Полный возврат | Чек формируется автоматически | Чек возврата прихода |
| Частичный возврат | Чек возврата прихода | Чек возврата прихода |
Проверьте, что вы корректно передаете данные для чеков:
- данные переданы в соответствующем запросе (зависит от сценария отправки чеков);
- переданы все обязательные параметры;
- значения параметров переданы в нужном формате;
- в чеке не более 100 товаров;
- сумма платежа совпадает с общей суммой чека (чтобы определить сумму чека, по каждому товару умножьте quantityнаamountи просуммируйте);
- все суммы в чеке положительные.
Если что-то будет не так, ЮKassa вернет ошибку.
Проверьте, что передаваемые данные соответствуют требованиям 54-ФЗ и ограничениям онлайн-касс:
- параметр exciseтолько у товаров с признаком предмета расчета «Подакцизный товар»;
- для товаров, продаваемых в кредит, создан отдельный чек: нельзя, чтобы в одном чеке были товары с признаком способа расчета «Кредит» и товары с другими признаками способа расчета;
- параметры product_code,country_of_origin_code,customs_declaration_numberтолько у товаров с признаками предмета расчета «Товар», «Подакцизный товар», «Несколько вариантов», «Другое».
Если что-то будет не так, онлайн-касса не сформирует чек — информация об ошибке отобразится в истории платежей (в тестовом магазине будет имитация ответа от онлайн-кассы). Статус платежа будет зависеть от сценария отправки чеков: в сценарии Сначала чек, потом платеж ЮKassa отменит платеж и автоматически сформирует чек возврата прихода; в других сценариях платеж пройдет.
Есть вопросы или замечания по документации?
Можем созвониться и обсудить их лично: мы поможем вам разобраться, а вы нам — понять, что тут нужно улучшить.
Для этого оставьте свои контакты и выберите время.
Да, хочу обсудить