Документация
  • Справка
Интеграция по API

Подключение

Создание тестовой заявки

Вызовите метод Create, используя свою демо-учетную запись и полученный ранее mlts-сертификат.

1. Заполните заявку тестовыми данными — ФИО, дата рождения, номер мобильного телефона.
Будьте внимательны при заполнении следующих полей:

  • Название заказа должно быть уникальным, лучше называть его в виде {название_магазина}_{id_заказа}. Количество символов в наименовании заказа не должно превышать 30;
  • Notification_url — адрес для http-нотификаций (вебхуков);
  • Fail_url — ссылка для редиректа в случае неуспешной оплаты;
  • Success_url — ссылка для редиректа в случае успешной оплаты;
    Поле order.prepaid_amount необходимо в случае, когда клиент оплачивает часть заказа баллами, а оставшуюся часть — Долями. В этом поле нужно передать предоплаченную сумму в рублях;
  • Order.prepaid_amount — предоплаченная часть заказа, например, часть суммы, списанная баллами;
  • Order.amount —  это оставшаяся сумма заказа, та часть, что осталась после списания баллов. Эта сумма разбивается на 4 платежа;
  • Полная сумма заказа = order.prepaid_amount + order.amount; при этом order.amount =items*price;
  • Сlient_info.phone — телефон клиента должен быть в формате +79991112233. Без пробелов и дефисов.

2. Заполните заявку любыми ФИО, датой рождения, мейлом и выберите любой способ оплаты, например, картой.

3. Вам придет вебхук approved, а после него вебхук wait_for_commit.

Вебхук Approved высылается когда клиенту была одобрена возможность воспользоваться Долями после ввода персональных данных.

Wait_for_commit высылается когда первые 25% стоимости заказа были захолдированы и мы готовы принять от магазина метод Commit. Этим методом магазин подтверждает заказ.

Необходимо проверять IP-адрес с которого пришел вебхук.

Уведомления банка приходят с маски сети 91.194.226.0/23. IP-адрес первого хоста — 91.194.226.1 и IP-адрес последнего хоста — 91.194.227.254, хостов в сети 510.

Можно вызвать метод Info самим, чтобы проверить текущий статус заказа.

Подтверждение заказа

Вызовите метод Commit с параметрами, указанными в методе Create.

Внимание! Метод Commit должен быть вызыван в течение 72 часов от момента вызова метода Create, в противном случае заказ будет отменен.

Сумма подтвержденного заказа не может превышать сумму, указанную при создании заказа. Сумма заказа в Commit может быть либо равной, либо отличаться в меньшую сторону от суммы в методе Create.

Если в Commit будет меньшая сумма, мы пересчитаем платежи и вернем клиенту разницу между суммой в Create и суммой в Commit. И график пересчитается с учётом новой суммы.
В ответ вы получите вебхуки committed и completed.

Проверка сценариев

Рекомендуем проверить все оставшиеся сценарии оплаты: «Неуспешная оплата» = payment-fail и «Отказ в услуге» = rejected.

  • Если вы передадите в Create_Demo, в параметре флоу payment-fail и заполните заявку, то сможете увидеть, что оплата не прошла — придет нотификация canceled по прошествии 24 ч.
  • Если вы передадите в Create_Demo в параметре флоу reject и заполните заявку, то получите отказ — придет нотификация rejected.

Проверка метода Cancel

Отменить заказ можно только в статусе wait_for_commit. Для этого вызовите метод Cancel. В ответ получите вебхук Canceled.

Проверка метода Refund

Вернуть заказа можно в статусах committed и completed. Возврат может быть как полный, так и частичный. В случае успешной проверки, в ответ вы получите код «200».

Старт продаж

  • После тестирования и настройки методов и вебхуков можно перейти к созданию реальных заявок.
  • Для создания реальных заявок используйте метод Create.
  • Для работы с методом Create, используйте боевые параметры, полученные от персонального менеджера, а также mtls-сертификат.
  • Расскажите своим клиентам о новом способе оплаты частями, используя маркетинговые материалы.