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