Тестирование
Вы можете протестировать все возможности API ЮKassa при оплате банковской картой и из кошелька ЮMoney, включая отправку данных для формирования чеков.
 
Тестовый магазин
Вы можете проверить свою интеграцию в тестовом магазине, прежде чем начнете принимать реальные платежи. При оплате в тестовом магазине все проходит, как при настоящих платежах, но деньги никуда не переводятся.
Для тестирования создайте тестовый магазин и настройте его: укажите URL для получения HTTP-уведомлений, получите в личном кабинете идентификатор и секретный ключ с префиксом test_. Используйте полученные данные для аутентификации запросов в API.
Вы можете создать максимум 5 тестовых магазинов. Подробнее о тестовом магазине и его настройке
Не отдавайте товар, за который заплатили через тестовый магазин. Чтобы избежать накладок, для тестовых уведомлений от ЮKassa используйте специальный URL (его нужно прописать в настройках тестового магазина в личном кабинете).
 
Возможности
Вы можете протестировать все возможности API, включая отправку данных для чеков, для следующих способов оплаты:
 
Оплата банковской картой
 
Тестовые банковские карты
Настоящие карты нельзя использовать в тестовом магазине. Вместо них проверяйте оплату с помощью тестовых карт.
Ниже приведены тестовые карты, которые относятся к разным платежным системам — для тестирования выбирайте любую карту. В качестве срока действия укажите любую дату (но больше текущей), CVC и код для прохождения 3-D Secure — любые числа.
 
Проверка успешных сценариев
Вы можете проверить оплату банковскими картами разных платежных систем:
НомерТип карты
5555555555554477Mastercard (с 3-D Secure)
5555555555554444Mastercard
6759649826438453Maestro
4793128161644804Visa (с 3-D Secure)
4111111111111111Visa
4175001000000017Visa Electron
2200000000000004Mir (с 3-D Secure)
2202474301322987Mir
370000000000002American Express
3528000700000000JCB
36700102000000Diners Club
 
Проверка неуспешных сценариев
Если вы хотите проверить значение параметра
cancellation_details
при неуспешных платежах, используйте любые тестовые карты разных платежных систем.
 
Отмена транзакции «внешними» участниками платежного процесса (payment_network)
Номер картыПричина отмены платежа
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
 
Отмена транзакции на стороне ЮKassa (yoo_money)
Номер картыПричина отмены платежа
5555555555554584 (Mastercard)
4969751510013864 (Visa)
2201382000000054 (Mir)
country_forbidden
5555555555554634 (Mastercard)
4119098878796485 (Visa)
2201696981989955 (Mir)
fraud_suspected
 
Оплата из кошелька ЮMoney
Для тестирования оплаты из кошелька ЮMoney тестовый кошелек не понадобится: в тестовом магазине платежи проходят без участия реального кошелька.
Перед оплатой вам необходимо выйти из аккаунта своего кошелька ЮMoney.
 
Работа с чеками
В тестовом магазине можно проверить проведение оплаты по 54-ФЗ. Взаимодействие с ЮKassa в режиме проверки чеков проходит как при настоящих платежах или возвратах: вам нужно передавать данные для формирования чеков и вы можете просматривать информацию о чеках в личном кабинете.
В режиме проверки чеков ЮKassa только имитирует взаимодействие с онлайн-кассой: тестовые данные не передаются в онлайн-кассу и ОФД, поэтому физический чек не формируется, а пользователь не получает письма от ЮKassa и чеки от ОФД.
Чтобы проверить работу с чеками:
  1. Настройте тестовый магазин: в личном кабинете перейдите в тестовый магазин, в разделе Настройки — Онлайн-Касса включите режим проверки чеков и выберите сценарий отправки данных.
  2. Проверьте работу с платежами и возвратами в соответствии с выбранным сценарием.
  3. Когда соберетесь принимать платежи от ваших реальных пользователей, проверьте, что в вашем настоящем магазине прописаны настройки онлайн-кассы.
 
Проверка оплаты по 54-ФЗ
Формирование чеков — это часть процесса проведения платежей и возвратов. На каждом этапе проверьте отправку данных для чеков и посмотрите, как чеки отображаются в истории платежей тестового магазина.
При тестировании в запросах передавайте идентификатор и секретный ключ тестового магазина, для оплаты используйте специальные тестовые карты и тестовый кошелек.
Проверьте, что на каждом этапе работы вы формируете нужные чеки в соответствии с выбранным сценарием отправки чеков.
 
Памятка по подготовке данных для чеков
 
Корректность запросов
Проверьте, что вы корректно передаете данные для чеков:
  • данные переданы в соответствующем запросе (зависит от сценария отправки чеков);
  • переданы все обязательные параметры;
  • значения параметров переданы в нужном формате;
  • в чеке не более 100 товаров;
  • сумма платежа совпадает с общей суммой чека (чтобы определить сумму чека, по каждому товару умножьте
    quantity
    на 
    amount
    и просуммируйте);
  • все суммы в чеке положительные.
Если что-то будет не так, ЮKassa вернет ошибку.
 
Корректность данных
Проверьте, что передаваемые данные соответствуют требованиям 54-ФЗ и ограничениям онлайн-касс:
  • параметр
    excise
    только у товаров с признаком предмета расчета «Подакцизный товар»;
  • для товаров, продаваемых в кредит, создан отдельный чек: нельзя, чтобы в одном чеке были товары с признаком способа расчета «Кредит» и товары с другими признаками способа расчета;
  • параметры
    product_code
    ,
    country_of_origin_code
    ,
    customs_declaration_number
    только у товаров с признаками предмета расчета «Товар», «Подакцизный товар», «Несколько вариантов», «Другое».
Если что-то будет не так, онлайн-касса не сформирует чек — информация об ошибке отобразится в истории платежей (в тестовом магазине будет имитация ответа от онлайн-кассы). Статус платежа будет зависеть от сценария отправки чеков: в сценарии Сначала чек, потом платеж ЮKassa отменит платеж и автоматически сформирует чек возврата прихода; в других сценариях платеж пройдет.

Есть вопросы или замечания по документации?

Можем созвониться и обсудить их лично: мы поможем вам разобраться, а вы нам — понять, что тут нужно улучшить. Для этого оставьте свои контакты и выберите время.
Да, хочу обсудить
 
Что почитать еще
Быстрый стартОсновы проведения платежейНеуспешные платежиОплата по 54-ФЗ