Документация
  • Справка
Интеграция по API
Подключение
Создание тестовой заявки

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

  • Заполните заявку тестовыми данными — ФИО, дата рождения, номер мобильного телефона.
    Будьте внимательны при заполнении следующих полей:
    • Название заказа должно быть уникальным, лучше называть его в виде {название_магазина}_{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. Без пробелов и дефисов
  • Заполните заявку любыми ФИО, датой рождения, мейлом и выберете любой способ оплаты, например, картой
  • Вам придет вебхук 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-сертификат
  • Расскажите своим клиентам о новом способе оплаты частями, используя маркетинговые материалы