Документация
  • Справка
Интеграция по 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 высылается когда клиенту была одобрена возможность воспользоваться Долями и были захолдированы первые 25% стоимости заказа
Wait_for_commit высылается когда мы готовы принять от магазина метод 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-сертификат
  • Расскажите своим клиентам о новом способе оплаты частями, используя маркетинговые материалы