Разовая оплата в две стадии

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

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

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

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

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

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

  • Если необходима аутентификация пользователя с использованием протокола 3‑D Secure, то от платформы к веб-сервису отправляется оповещение с информацией для формирования запроса к эмитенту, после чего проведение платежа в платформе приостанавливается до получения информации о результате аутентификации. При работе через Gate для этого требуется отправить запрос с результатом аутентификации — 3ds_result, — а при работе через Payment Page все действия выполняются без участия веб-сервиса мерчанта.
  • Если необходимо дополнение информации о платеже для какой-либо из сторон, участвующих в проведении платежа (например, предоставление в платёжную систему адреса держателя карты, не переданного в исходном запросе), то от платформы к веб-сервису отправляется оповещение с названиями параметров для уточнения и проведение платежа в платформе приостанавливается до получения необходимой информации. При работе через Gate для этого требуется отправить запрос с такой информацией — clarification, — а при работе через Payment Page все действия выполняются без участия веб-сервиса.

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

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

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

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

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

  • reversal, если возврат инициируется до закрытия операционного дня, вне зависимости от суммы оплаты для карт платёжной системы Mastercard и при условии возврата всей суммы оплаты для карт других платёжных систем;
  • refund, если возврат инициируется для карт любых платёжных систем после закрытия операционного дня и вне зависимости от суммы, а также до закрытия операционного дня при условии возврата части суммы оплаты для карт всех платёжных систем, кроме Mastercard.
Рис. 1. Диаграмма состояний разовой двухстадийной оплаты

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

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

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

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

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

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

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

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

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

decline Операция отклонена Конечное состояние
success Операция выполнена Конечное состояние

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

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

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

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

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