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

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

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

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

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

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

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

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

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

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

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

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

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

Проведение платежа приостановлено до получения уведомления с результатом со стороны платежной системы. В зависимости от результата на стороне платежной системы платеж переводится в статус success или decline.

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

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

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

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

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

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

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

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

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

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

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

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

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