# Тестирование

# Тестовые карты

Данные карт для проверки работоспособности на тестовом (sandbox) окружении для всех запросов, кроме Routes.

Параметр Значение Комментарий
Срок действия Любой Позднее текущего месяца в формате ММ/ГГ
Имя держателя карты CARD HOLDER
CVV Любой
Номер карты 4929509947106878 Для имитации успешных транзакций без 3DSecure
Номер карты 4692065455989192 Для имитации успешных транзакций с 3DSecure
Номер карты 4485913187374384 Для имитации неуспешных транзакций без 3DSecure
Номер карты 4556058936309366 Для имитации неуспешных транзакций с 3DSecure
Номер карты 5192618384533242 Для имитации интерактивной оплаты с принудительным переводом карты в payout-only

# Тестовые карты (Routes)

Данные тестовых карт для проверки работоспособности на тестовом (sandbox) окружении для запросов Routes.

Параметр Значение Комментарий
Срок действия Любой Позднее текущего месяца в формате ММ/ГГ
Имя держателя карты CARD HOLDER
CVV Любой
Номер карты 4782776496928582, 5167448623781910, 6762355253772803 Для имитации неуспешных транзакций
Номер карты 4692065455989192, 5210177935176090, 6761438221045105 Для имитации успешных транзакций (без 3-D Secure)

# Коллекция для Postman

Чтобы сделать процесс тестирования и ознакомления с возможностями платежного API удобнее, мы подготовили коллекции для Postman. Для работы с ними необходимо пройти следующие шаги:

  1. Загрузить и сохранить как файл одну из коллекций:
  1. Установить и запустить программу Postman(opens new window) .

  2. Импортировать коллекцию mandarin_api.postman_collection.json или mandarin_routes_api.postman_collection.json, выбрав "File" -> "Import..."

File -> Import...

Затем нажать на кнопку "Upload Files" и выбрать сохраненный файл коллекции.

Upload Files

  1. Прописать свои авторизационные данные в переменные коллекции. Для этого нужно нажать на "хлебные крошки" рядом с названием коллекции, затем выбрать пункт меню "Edit".

Edit

В открывшемся окне необходимо перейти на закладку "Variables" и прописать напротив переменных merchant_id и secret значения "Merchant id" и "Secret" из вашего личного кабинета.

Для всех запросов, кроме Routes: Если вы пропишете авторизационные данные из тестового личного кабинета, то транзакция будет выполнена на тестовом (sandbox) окружении, а если из боевого - то на боевом (production).

Редактирование значений переменных коллекции

Для запросов Routes: За переключение между тестовым и боевым окружениями отвечает переменная domain. Для тестового (sandbox) окружения она принимает значение api-sandbox.mandarinpay.com (по умолчанию), для перехода на боевое (production) окружение нужно прописать в нее значение api.mandarinpay.com и, конечно, изменить авторизационные данные merchant_id и secret на боевые.

Редактирование значений переменных коллекции Routes

В заключение, надо сохранить изменения кнопкой "Update".

  1. Только для запросов Routes: для заведения и упрощенной идентификации аккаунта, необходимо будет указать существующий номер мобильного телефона (на него будет отправлен СМС-код) и персональные данные существующего гражданина РФ (запрос идентификации будет отправлен в СМЭВ, если данные будут некорректными, то упрощенная идентификация не будет пройдена, и продолжить тестовый сценарий будет невозможно).

Переменную sms_code можно будет заполнить только после выполнения запроса "Инициализация процесса идентификации по паспорту и СНИЛС" или "Инициализация процесса идентификации по паспорту и ИНН". В результате вы получите СМС с шестизначным кодом, который нужно будет ввести в переменную, и затем выполнить запрос "# Передача СМС-кода" (префикс "#" в названии запроса указывает, что перед его выполнением потребуется актуализировать значение переменной).

В заключение, надо сохранить изменения кнопкой "Update".

Ввод персональных данных в переменные коллекции Routes

  1. Вы можете отправлять запросы!

Рекомендуем запускать их по порядку (нажатием на кнопку "Send"). При этом некоторые запросы в названии имеют префикс с восклицательным знаком:

  • ! Одностадийная оплата.
  • ! Двухстадийная оплата - Авторизация.
  • ! Токенизация полных карточных данных.

Для успешного завершения таких запросов нужно открыть в браузере ссылку, которая вернется в параметре ответа userWebLink. Иначе некоторые последующие запросы будут завершаться с ошибкой, поскольку ссылаются на их результаты.

Отправка запроса, получение

  1. Откройте в браузере ссылку userWebLink.

Нужно будет ввести данные карты:

  • Для тестового окружения: используйте номер карты 4692065455989192 для успешной операции, остальные данные - любые.

  • Для боевого окружения: вводите данные своей реальной карты. При этом с нее будут списаны денежные средства.

Потом нажмите на кнопку "Оплата".

Заполнение данных карты на платежной странице

Если вы запрашивали токенизацию, то на этом процесс завершен.

Если вы выполняли оплату, то откроется страница со успешным статусом оплаты.

Успешный статус

  1. Тестовый терминал не поддерживает авторизацию по токену карты: как для Routes, так и для всех запросов, кроме Routes. Поэтому запрос "% Двухстадийная оплата - Авторизация с использованием токена карты" будет неуспешен. Вы можете обговорить возможность авторизации по токену карты с вашим менеджером при заведении боевого терминала, и данный запрос в рамках Routes станет доступным для вас уже на боевом (production) окружении.

  2. Если результат выполнения запроса в Postman вас устраивает, то вы можете легко сгенерировать код для отправки этого запроса на любом языке программирования средствами Postman.

Для этого нажмите на кнопку "Code" в правой части окна (как на рисунке ниже). В открывшимся окне выберете язык программирования и скопируйте исходный код.

Генерирование code snippet