Интеграция по API

Тестовая заявка

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

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

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

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

2. Вам придет вебхук 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.