Схема и статусы разовой оплаты в две стадии

Общая информация

Разовая оплата в две стадии, или разовая двухстадийная оплата, — это тип платежа, в рамках которого для перевода денежных средств от пользователя к мерчанту сначала, на основании исходного запроса, осуществляется их предварительная блокировка, а затем, на основании подтверждающего запроса или по истечении заданного периода, — списание.

Этот вариант может быть актуален, когда необходимо гарантировать возможность последующего списания или отмены блокировки суммы в зависимости от ситуации (например, при бронировании номера в отеле).

С помощью Payment Page можно выполнить первую стадию такой оплаты — блокировку средств пользователя. Для выполнения второй стадии — списания заблокированных средств или отмены блокировки — необходимо использовать интерфейс Gate либо настроить автоматическое выполнение этой стадии по истечении заданного времени.

Схема проведения

Чтобы инициировать первую стадию оплаты, в параметрах вызова платежной формы следует указывать режим работы purchase и тип операции auth. Тогда после подтверждения пользователем согласия на проведение платежа в платежную платформу направляется запрос, для выполнения которого в платформе формируется операция auth. И результатом выполнения этой операции является предварительная блокировка средств на счете пользователя.

При проведении первой стадии могут выполняться вспомогательные процедуры: аутентификация пользователя с использованием технологии 3‑D Secure, аутентификация пользователя со стороны платежной системы по инициативе мерчанта и (или) дополнение информации о платеже. Такие процедуры выполняются без участия веб-сервиса мерчанта, но, как правило, требуют участия пользователя.

Вторая стадия такой оплаты может быть инициирована по запросу со стороны веб-сервиса мерчанта или автоматически через заданный период на стороне платежной платформы.

Чтобы инициировать вторую стадию по запросу, следует использовать интерфейс Gate. Для выполнения этой стадии используется одна из следующих операций:

  • capture, если выполняется списание заблокированных средств;
  • cancel, если выполняется отмена блокировки средств.

Подробную информацию об автоматическом инициировании второй стадии необходимо уточнять у курирующего менеджера.

После проведения второй стадии разовой оплаты по этой оплате можно выполнить возврат средств пользователю. Чтобы инициировать его выполнение, следует использовать интерфейсы Gate или Dashboard. При этом используется одна из следующих операций:

  • reversal, если возврат инициируется до закрытия операционного дня, в котором был проведен платеж;
  • refund, если возврат инициируется после закрытия операционного дня, в котором был проведен платеж.

Рис.: Диаграмма состояний разовой двухстадийной оплаты

Далее в рамках данного раздела представлена информация о возможных статусах разовой двухстадийной оплаты и связанных с ней операций. Более подробную информацию о проведении первой стадии разовой двухстадийной оплаты можно найти в разделе Блокировка средств.

Статусы платежа

При проведении разовой двухстадийной оплаты могут использоваться следующие статусы.

error Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого в платежной платформе запроса Конечное состояние. Допускается повторное инициирование этого платежа
processing Платеж проводится Промежуточное состояние
awaiting 3ds result Проведение платежа приостановлено до получения в платежной платформе информации о результате аутентификации 3‑D Secure. Если информация о результате не получена в течение установленного времени, то платеж переводится в статус decline. Как правило, это время составляет 30 минут, но может варьироваться в зависимости от используемого провайдера. Для получения более подробной информации о времени ожидания следует обращаться к специалистам технической поддержки — support@rocketpay.kz Промежуточное состояние
awaiting merchant auth Проведение платежа приостановлено до получения в платежной платформе информации о результате аутентификации пользователя по инициативе мерчанта Промежуточное состояние
awaiting redirect result Проведение платежа приостановлено до получения уведомления с результатом со стороны платежной системы. В зависимости от результата на стороне платежной системы платеж переводится в статус success или decline Промежуточное состояние
awaiting clarification Проведение платежа приостановлено до получения дополнительной информации от пользователя. Если такая информация не получена в течение 30 минут, платеж переводится в статус decline Промежуточное состояние
awaiting customer Проведение платежа приостановлено до получения со стороны пользователя данных, необходимых для выполнения повторной попытки. При получении этих данных платеж переводится в статус processing. При отказе пользователя или истечении времени на выполнение повторных попыток платеж переводится в статус decline (подробнее — в разделе Повторные попытки проведения платежа) Промежуточное состояние
awaiting capture Проведение платежа приостановлено до получения запроса на списание (capture) или на отмену предварительной блокировки средств (cancel) Промежуточное состояние
canceled Предварительная блокировка средств, выполненная по запросу auth, отменена Конечное состояние
decline Платеж отклонен Конечное состояние
success Платеж проведен Конечное состояние. Дополнительно допускается проведение возврата
partially reversed Сумма платежа частично возвращена Конечное состояние
reversed Сумма платежа полностью возвращена до закрытия бизнес-дня, в котором он был проведен Конечное состояние
partially paid Платеж с разбиением суммы частично проведен по запросу capture Конечное состояние. Дополнительно допускается отмена возврата
partially refunded Сумма платежа частично возвращена Конечное состояние. Дополнительно допускается отмена возврата
refunded Сумма платежа полностью возвращена после закрытия бизнес-дня, в котором он был проведен. Осуществлен один полный возврат суммы платежа или несколько частичных, в совокупности составляющих исходную сумму Конечное состояние. Дополнительно допускается отмена возврата

Статусы операции auth

При выполнении операции auth могут использоваться следующие статусы.

processing Операция выполняется Промежуточное состояние
awaiting 3ds result Выполнение операции приостановлено до получения в платежной платформе информации о результате аутентификации 3‑D Secure. Если информация о результате не получена в течение установленного времени, то операция переводится в статус decline. Как правило, это время составляет 30 минут, но может варьироваться в зависимости от используемого провайдера. Для получения более подробной информации о времени ожидания следует обращаться к специалистам технической поддержки — support@rocketpay.kz Промежуточное состояние
awaiting merchant auth Выполнение операции приостановлено до получения в платежной платформе информации о результате аутентификации пользователя по инициативе мерчанта Промежуточное состояние
awaiting redirect result Выполнение операции приостановлено до получения уведомления с результатом от платежной системы. В зависимости от результата операция переводится в статус success или статус decline Промежуточное состояние
awaiting clarification Выполнение операции приостановлено до получения от пользователя дополнительной информации. Если такая информация не получена в течение 30 минут, операция переводится в статус decline Промежуточное состояние
decline Операция отклонена Конечное состояние
success Операция выполнена Конечное состояние

Статусы операций capture и cancel

При выполнении capture и cancel могут использоваться следующие статусы.

processing Операция выполняется Промежуточное состояние
awaiting clarification Выполнение операции приостановлено до получения от пользователя дополнительной информации. Если такая информация не получена в течение 30 минут, операция переводится в статус decline Промежуточное состояние
decline Операция отклонена Конечное состояние
success Операция выполнена Конечное состояние

Статусы операций reversal и refund

Статусы операций reversal и refund совпадают со статусами операций capture и cancel.

Дополнительные материалы

При работе с двухстадийными оплатами могут быть полезны следующие материалы: