Двухстадийный платеж
Сценарий двухстадийной оплаты - заморозка средств покупателя и последующее списание в течение 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 первой стадии (как и для одностадийного платежа). Нотификация второй стадии может прийти спустя несколько дней - в зависимости от того, когда вы запросите списание средств.