Инструкции
Помощь
Подключить ЮKassa
Тестирование платежей
В этой статье описано, как проверять платежи в тестовом режиме ЮKassa. При использовании тестового режима всё проходит, как при настоящих платежах, но деньги никуда не переводятся.
О тестовом режиме
Тестовый режим доступен сразу после регистрации в личном кабинете ЮKassa — вы можете протестировать платежи в любой момент, даже до указания данных компании и заключения договора.
Чтобы использовать тестовый режим, нужно зарегистрироваться в личном кабинете ЮKassa и создать тестовый магазин.
В тестовом режиме доступны все основные возможности API, даже те, которые для настоящего магазина нужно подключать через менеджера ЮKassa.
Особенности использования тестового режима:
  • для аутентификации запросов необходимо использовать идентификатор и секретный ключ тестового магазина;
  • в запросах необходимо передавать специальные тестовые данные (зависят от того, какую функциональность вы проверяете);
  • в объектах платежей, созданных для тестового магазина, параметр
    test
    принимает значение
    true
    .
Пример тестового платежа
JSON
{
  "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 и после.
Если вы не зарегистрированы в ЮKassa
Шаг 1. Зарегистрируйтесь в ЮKassa по этой ссылке.
Шаг 2. В процессе увидите два варианта: продолжить регистрацию или перейти к тестированию платежей. Выберите тестирование. Вам отобразится созданный тестовый магазин.
Если у вас есть личный кабинет ЮKassa
Шаг 2. Нажмите Все магазины и выплаты, затем Добавить магазин.
Шаг 3. Выберите добавление тестового магазина, выберите нужные вам настройки и нажмите Добавить. Вам отобразится созданный тестовый магазин.
Вы можете создать максимум 5 тестовых магазинов.
Тестирование интеграции
Шаг 1. Получите идентификатор и секретный ключ тестового магазина. Они нужны для аутентификации запросов.
Шаг 2. Настройте тестовый магазин:
Шаг 3. Выберите ту функциональность, которую хотите протестировать:
Шаг 4. Протестируйте выбранную функциональность по инструкциям.
Не отдавайте товар, за который заплатили через тестовый магазин. Чтобы избежать накладок, для тестовых уведомлений от ЮKassa используйте специальный URL (его нужно прописать в настройках тестового магазина в личном кабинете).
Оплата банковской картой
Тестовые банковские карты
Настоящие карты нельзя использовать в тестовом магазине. Вместо них проверяйте оплату с помощью тестовых карт.
Ниже приведены тестовые карты, которые относятся к разным платежным системам — для тестирования выбирайте любую карту. В качестве срока действия укажите любую дату (но больше текущей), CVC и код для прохождения 3-D Secure — любые числа.
Проверка успешных сценариев
При тестировании автоплатежей выбирайте тестовые карты без 3-D Secure, иначе повторный платеж не пройдет.
Вы можете проверить оплату банковскими картами разных платежных систем:
НомерТип карты3-D Secure
5555555555554477Mastercard✔️
5555555555554444Mastercard
6759649826438453Maestro
4793128161644804Visa✔️
4111111111111111Visa
4175001000000017Visa Electron
2200000000000004Mir✔️
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 и на отобразившейся платежной форме нажмите Заплатить. Платеж завершится успешно.
Если вы используете сценарий интеграции Виджет ЮKassa, на платежной форме будет доступна только оплата банковской картой. Кошелек ЮMoney также будет отображаться на платежной форме, но его нельзя использовать для оплаты.
Тестирование автоплатежей
При оплате банковской картой вы можете проверить успешные и неуспешные сценарии, а при оплате из кошелька ЮMoney — только успешные.
Успешный сценарий
Проверьте успешный сценарий сохранения способа оплаты и проведения платежа с использованием сохраненного способа оплаты.
Для тестирования оплаты из кошелька ЮMoney тестовый кошелек не понадобится. При тестировании оплаты с банковской карты используйте тестовые банковские карты без прохождения аутентификации по 3-D Secure, например
5555
5555
5555
4444
(Mastercard).
Неуспешные сценарии
Проверьте неуспешные сценарии на каждом этапе проведения автоплатежей.
Неуспешный сценарий при сохранении способа оплаты
Вы можете проверить сценарий, в котором платеж с сохранением способа оплаты не проходит. Например, из-за недостатка денег на карте.
Для этого при проведении платежа для оплаты используйте специальные тестовые банковские карты.
Неуспешный сценарий при платеже с использованием сохраненного способа оплаты
Вы можете проверить сценарий, в котором сохранение способа оплаты успешно, а при повторном платеже оплата не проходит.
Для этого проведите платеж с сохранением способа оплаты с помощью специальной тестовой карты, затем используйте идентификатор сохраненного способа оплаты для повторного платежа. Оплата сохраненным способом не пройдет из-за нехватки денег на карте. В объекте платежа  будет указана причина отмены
insufficient_funds
.
Для тестирования этого сценария используйте следующие тестовые банковские карты:
  • 5555
    5555
    5555
    4642
    (Mastercard)
  • 4000
    0000
    0000
    0002
    (Visa)
  • 2200
    0000
    0000
    0079
    (Mir)
Работа с чеками
В тестовом магазине можно проверить проведение оплаты по 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-ФЗ