Разовая оплата в одну стадию

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

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

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

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

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

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

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

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

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

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

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

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

error Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого запроса Конечное состояние. Допускается повторная отправка запроса с тем же идентификатором платежа и повторная попытка проведения этого платежа
processing Платёж проводится Промежуточное состояние
awaiting 3ds result Проведение платежа приостановлено до получения запроса на продолжение с учётом результата аутентификации 3‑D Secure3ds_result. Если такой запрос не получен в течение установленного времени, то платёж переводится в статус decline. Как правило, время ожидания такого запроса составляет 30 минут, но может варьироваться в зависимости от используемого провайдера. Для получения более подробной информации о времени ожидания следует обращаться к специалистам технической поддержки — support@ecommpay.com Промежуточное состояние
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 Сумма платежа полностью возвращена после закрытия бизнес-дня, в котором он был проведён. Осуществлён один полный возврат суммы платежа или несколько частичных, в совокупности составляющих исходную сумму Конечное состояние. Дополнительно допускается отмена возврата
reversed Сумма платежа полностью возвращена до закрытия бизнес-дня, в котором он был проведён Конечное состояние. Дополнительно допускается отмена возврата

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

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

processing Операция выполняется Промежуточное состояние
awaiting 3ds result Выполнение операции приостановлено до получения запроса на продолжение с учётом результата аутентификации 3‑D Secure3ds_result. Если такой запрос не получен в течение установленного времени, то операция переводится в статус decline. Как правило, время ожидания такого запроса составляет 30 минут, но может варьироваться в зависимости от используемого провайдера. Для получения более подробной информации о времени ожидания следует обращаться к специалистам технической поддержки — support@ecommpay.com Промежуточное состояние
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 Операция выполнена Конечное состояние

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

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