Рекуррентный платеж
Рекуррентный платеж
Описание процесса работы
В системе WEBPAY существует два способа осуществления оплаты без участия Держателя карты:
- Рекуррентные платежи — это платежи с определенной периодичностью, осуществляемые без участия Держателя карты, по требованию Магазина: при наступлении определенных событий либо на регулярной основе. В качестве требования Магазина выступает специально сформированный запрос, отправляемый на ресурс платежного сервиса.
- Credential on File (CoF) — это платежи, осуществляемые по привязанной карте, в которых не соблюдается периодичность списаний. Инициатором таких списаний может выступать:
- Магазин,
- Держатель карты.
До проведения рекуррентных (CoF) платежей необходимо осуществить инициирующий платеж, служащий контрактом, с участием Держателя карты и с вводом всех данных карты по стандартному сценарию. Дальнейшее осуществление рекуррентных (CoF) платежей происходит без участия Держателя карты и без передачи CVV/CVC. Инициирующий платёж поддерживает 3D-Secure (3DS). Рекуррентные (CoF) платежи не имеют возможности обеспечить поддержку 3DS.
Сумма рекуррентного (CoF) платежа может не совпадать с суммой инициирующего платежа. Настройки типа транзакции осуществляются на стороне WEBPAY в зависимости от бизнес-процесса Магазина.
Сценарий использования рекуррентных (CoF) платежей
Держатель карты осуществляет переход с ресурса Магазина POST-запросом на ресурс платежного сервиса, после чего Держателю карты предлагается ввести реквизиты банковской платежной карты и дополнительные параметры. Далее осуществляется стандартный сценарий проведения платежа, включая, при необходимости, прохождение 3DS.
В случае успешного завершения платежа сервис привязывает карту к Держателю карты Магазина, идентифицируемого описанным далее способом.
По завершении платежа возможен переход на ресурс Магазина на один из URL, указанных Магазином (для случаев успешного (параметр wsb_return_url) и неудачного (параметр wsb_cancel_return_url) завершения платежа). Дополнительно отправляется нотификатор на еще один URL (параметр wsb_notify_url). Нотификатор с сообщением о результате инициирующего платежа содержит идентификатор пользователя, маскированный номер карты и срок действия подписки на механизм рекуррентных (CoF) платежей.
При успешном инициирующем платеже Магазин может проводить рекуррентные (CoF) платежи.
Идентификацонный номер держателя карты, параметры привязки карты
Держатель карты должен быть зарегистрирован на ресурсе Магазина. Магазин присваивает ему уникальный идентификатор, передаваемый в запросах на проведение платежей как параметр wsb_сustomer_id. К данному идентификатору для данного Магазина (wsb_storeid) будет осуществлена привязка карты.
Поля формы оплаты для рекуррентных платежей
Система WEBPAY предусматривает два способа формирования заказов на оплату:
- JSON API.
- Создание HTML-страницы с обыкновенной HTML-формой.
Для указания в авторизационном запросе использования рекуррентных (CoF) платежей необходимо дополнительно использовать следующие поля:
Обратите внимание
Все текстовые поля должны быть в кодировке UTF-8.
| Название поля | Обязательное поле | Описание поля | Примечание |
|---|---|---|---|
wsb_customer_id | да | Уникальный идентификатор пользователя в Магазине | Максимальная длина поля 64 символа. Поле не чувствительно к регистру |
wsb_operation_type | да | Обозначает тип запроса | Допустимые значения:
|
wsb_recurring_token | да | Уникальный токен привязки карты к идентификатору пользователя в Магазине (wsb_customer_id) | Значение данного поля соответствует значению поля recurring_token, переданного в нотификаторе после привязки карты |
Адреса платежного сервиса для осуществления запросов
Для осуществления рекуррентных (CoF) запросов в тестовом режиме необходимо использовать адрес https://securesandbox.webpay.by, для совершения реальных платежей https://payment.webpay.by.