Платежи с холдированием

Вы можете проводить платежи с холдированием: сначала замораживать сумму платежа на карте покупателя, а потом списывать отдельным запросом. Между заморозкой и списанием есть время, например, чтобы отправить заказ покупателю.

Как это работает

На самом деле все платежи банковскими картами проходят в две стадии. Сначала авторизация — банк проверяет, что нужная сумма есть на карте, и блокирует ее. Затем клиринг — банк списывает деньги.

При обычном платеже картой между авторизацией и клирингом практически нет паузы.

При платеже с холдированием вы решаете, когда провести клиринг. Банк списывает деньги не сразу, а по вашей команде. Можно списать полную сумму или меньше.

Как включить холдирование

Холдирование включается на стороне Банка 131. Все ваши платежи могут проходить или с холдированием, или без него (тогда сумма платежа будет списываться автоматически, сразу после авторизации).

Если хотите проводить платежи с холдированием, напишите вашему менеджеру в Банке 131.

Срок холдирования

Деньги замораживаются на карте на 5 дней. Если до конца этого срока вы не спишите их и не разблокируете, деньги разблокируются автоматически.

Если вам нужно, чтобы деньги после окончания срока холдирования списывались, а не разблокировались, напишите менеджеру в Банке 131.

Сценарий платежа c холдированием

1. Создайте платежную сессию отдельно от платежа (session/create) или одновременно с ним (session/init/payment).

   В этот момент можно подключить виджет платежной формы.

2. Если не используете виджет и создавали сессию отдельно от старта платежа, отправьте запрос session/start/payment.

3. Дождитесь от Банка 131 вебхука ready_to_confirm — это значит, что Банк готов провести платеж и ждет вашего подтверждения.

4. Подтвердите проведение платежа (session/confirm) или отмените его (session/cancel).

5. Если проводите оплату без платежной формы, дождитесь вебхука action_required от Банка 131. Это значит, что для проведения платежа нужны дополнительные действия. Например, пользователю нужно пройти 3D Secure.

6. Перенаправьте пользователя на адрес для 3D Secure.

7. Дождитесь вебхука ready_to_capture от Банка 131. Это значит, что деньги для оплаты успешно заморожены на банковской карте пользователя. Их можно списать — сразу или через некоторое время. Списать можно полную сумму или меньше — передайте нужную сумму в amount_details.

8. Спишите захолдированную сумму, меньшую сумму (session/capture) или отмените оплату (session/cancel).

9. Дождитесь от Банка 131 вебхука payment_finished с результатом проведения платежа. Статус succeeded сообщает вам, что платеж успешно проведен.

Схема платежа с холдированием

На этой схеме показан платеж с холдированием, со стартом сессии отдельно от платежа, на сервисе, не использующем виджеты.