Платежи с холдированием
Вы можете проводить платежи с холдированием: сначала замораживать сумму платежа на карте покупателя, а потом списывать отдельным запросом.
Между заморозкой и списанием есть время, например, чтобы отправить заказ покупателю.
Как это работает
На самом деле все платежи банковскими картами проходят в две стадии. Сначала авторизация — банк проверяет, что нужная сумма есть на карте, и блокирует ее. Затем клиринг — банк списывает деньги.
При обычном платеже картой между авторизацией и клирингом практически нет паузы.
При платеже с холдированием вы решаете, когда провести клиринг. Банк списывает деньги не сразу, а по вашей команде. Можно списать полную сумму или меньше.
Как включить холдирование
Холдирование включается на стороне Банка 131. Все ваши платежи могут проходить или с холдированием, или без него (тогда сумма платежа будет списываться автоматически, сразу после авторизации).
Если хотите проводить платежи с холдированием, напишите вашему менеджеру в Банке 131.
Срок холдирования
Деньги замораживаются на карте на 5 дней. Если до конца этого срока вы не спишете их и не разблокируете, деньги спишутся автоматически.
Если вам нужно, чтобы деньги после окончания срока холдирования не списывались, а разблокировались, напишите менеджеру в Банке 131.
Cценарий платежа c холдированием
- Вы создаете платежную сессию отдельно от платежа (
session/create
) или одновременно с ним (session/init/payment
).
В этот момент можно подключить виджет платежной формы.
- Если не используете виджет и создавали сессию отдельно от старта платежа,
отправляете запрос
session/start/payment
. - Получаете от Банка 131 вебхук
ready_to_confirm
— это значит, что Банк готов провести платеж и ждет вашего подтверждения. - Подтверждаете проведение платежа (
confirm_request
) или отменяете его (cancel_request
). - Если проводите оплату без платежной формы, получаете вебхук
action_required
от Банка 131. Это значит, что для проведения платежа нужны дополнительные действия. Например, пользователю нужно пройти 3-D Secure. - Перенаправляете пользователя на адрес для 3-D Secure.
- Получаете вебхук
ready_to_capture
от Банка 131. Это значит, что деньги для оплаты успешно заморожены на банковской карте пользователя. Их можно списать — сразу или через некоторое время. Списать можно полную сумму или меньше — передайте нужную сумму в AmountDetails. - Списываете захолдированную сумму, меньшую сумму (
session/capture
) или отменяете оплату (cancel_request
). - Получаете от Банка 131 вебхук
payment_finished
с результатом проведения платежа. Статусsucceeded
сообщает вам, что платеж успешно проведен.
Схема платежа с холдированием
На этой схеме показан платеж с холдированием, со стартом сессии отдельно от платежа, на сервисе с сертификатом PCI DSS (без виджетов).