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

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

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

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

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

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

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

Если для использованного платежного метода поддерживается проведение возвратов, то после проведения разовой оплаты в одну стадию по этой оплате можно выполнить возврат средств пользователю. Чтобы инициировать возврат, следует отправить в платформу запрос категории 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 redirect result либо awaiting customer action, но не оба этих статуса

 Промежуточное состояние
awaiting customer action

Проведение платежа приостановлено до выполнения необходимых действий пользователем со стороны платежной системы (в соответствии со спецификой платежного метода). В зависимости от результата этих действий платеж переводится в статус success или статус decline.

В рамках проведения одного платежа может использоваться awaiting customer action либо awaiting redirect result, но не оба этих статуса

 Промежуточное состояние
awaiting clarification Проведение платежа приостановлено до получения запроса на продолжение с учетом требуемой дополнительной информации — clarification (подробнее — в разделе Дополнение информации о платеже). Если такой запрос не получен в течение 30 минут, платеж переводится в статус decline Промежуточное состояние
awaiting customer Проведение платежа приостановлено до получения результата повторных попыток со стороны пользователя. При успешной повторной попытке платеж переводится в статус success, а при истечении числа безуспешных попыток — в статус decline (подробнее — в разделе Повторные попытки проведения платежа) Промежуточное состояние
decline Платеж отклонен Конечное состояние
success Платеж проведен Конечное состояние. Дополнительно допускается проведение возврата
partially paid Платеж с разбиением суммы частично проведен одной из операций sale Конечное состояние. Дополнительно допускается проведение возврата
partially refunded Сумма платежа частично возвращена Конечное состояние. Дополнительно допускается отмена возврата
refunded Сумма платежа полностью возвращена после закрытия бизнес-дня, в котором он был проведен. Осуществлен один полный возврат суммы платежа или несколько частичных, в совокупности составляющих исходную сумму Конечное состояние. Дополнительно допускается отмена возврата
partially reversed Сумма платежа частично возвращена Конечное состояние
reversed Сумма платежа полностью возвращена до закрытия бизнес-дня, в котором он был проведен Конечное состояние

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

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

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 customer action Выполнение операции приостановлено до выполнения необходимых действий пользователем со стороны платежной системы (в соответствии со спецификой платежного метода). В зависимости от результата этих действий операция переводится в статус success или статус decline Промежуточное состояние
awaiting clarification Выполнение операции приостановлено до получения запроса на продолжение с учетом требуемой дополнительной информации — clarification (подробнее — в разделе Дополнение информации о платеже). Если такой запрос не получен в течение 30 минут, операция переводится в статус decline Промежуточное состояние
decline Операция отклонена Конечное состояние
success Операция выполнена Конечное состояние

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

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

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

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

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