Перейти к содержимому

Двухстадийный платеж

Сценарий двухстадийной оплаты - заморозка средств покупателя и последующее списание в течение 7 суток.

Двухстадийный платеж проходит в два этапа: сначала заморозка (холдирование) средств у покупателя, потом зачисление на счет продавца. Пока средства заморожены, платеж можно отменить без уплаты комиссии.

Типовые применения: бронирование отелей и билетов, маркетплейсы (списание после подтверждения наличия товара), аренда с депозитом, услуги с подтверждением исполнителя.

Пошаговый сценарий

Клиент выбирает онлайн-оплату на сайте или в приложении.

Продавец регистрирует платеж POST /v1/ecom/payments с sessionType: "twoStep". Остальные параметры - как в одностадийном сценарии (сумма, orderId, returnUrl, опционально notificationUrl, ИНН, КПП).

АТОЛ Pay возвращает data.orderId и data.paymentUrls.main. Продавец перенаправляет клиента на платежную форму.

Клиент оплачивает на платежной странице (антифрод и 3-D Secure - как в одностадийном сценарии). При успехе АТОЛ Pay блокирует денежные средства на счету клиента.

Продавец получает callback первой стадии: при успехе ожидается paymentStatus: 11 (awaitingDeposit - «Ожидает списания»).

Продавец не позднее чем через 7 суток запрашивает списание заблокированных средств - методом POST /v1/ecom/payments/{orderId}/deposit или кнопкой «Провести списание» в личном кабинете.

Списание по второй стадии не происходит автоматически: метод deposit нужно вызвать не позднее 7 суток после оплаты. Что происходит с холдом после этого срока, документация АТОЛ не описывает - уточните у поддержки.

АТОЛ Pay завершает транзакцию, списывает средства со счета клиента и отправляет callback второй стадии (type: "deposit"): при успехе paymentStatus: 1 (success).

Sequence-диаграмма

Загрузка диаграммы…

Отмена на этапе заморозки

Пока платеж в статусе «Ожидает списания» (awaitingDeposit), его можно отменить полностью (частично - только для Т-Банка; в Альфа-Банке частичная отмена на первой стадии вернет PARTIAL_REFUND_IS_NOT_POSSIBLE) методом POST /v1/ecom/payments/{orderId}/cancel - комиссия при этом не списывается. После проведения второй стадии операция станет возвратом.

Определение успеха платежа

Чтобы определить успешное проведение платежа, достаточно callback первой стадии (как и для одностадийного платежа). Нотификация второй стадии может прийти спустя несколько дней - в зависимости от того, когда вы запросите списание средств.