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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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