Разовая оплата в одну стадию
Общая информация
Разовая оплата в одну стадию, или разовая одностадийная оплата, — это тип платежа, в рамках которого на основании одного исходного запроса осуществляется один (разовый) перевод денежных средств от пользователя к мерчанту. Это базовый вариант для проведения оплат — с незамедлительным разовым списанием средств (например, для расчёта за совершённую покупку).
Схема проведения
Чтобы инициировать оплату в одну стадию, следует отправить в платформу запрос категории 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@ecommpay.com |
Промежуточное состояние |
awaiting merchant auth |
Проведение платежа приостановлено до получения запроса на завершение аутентификации пользователя в платёжной системе по инициативе мерчанта — merchant_auth со значением finish для параметра type |
Промежуточное состояние |
awaiting redirect result |
Проведение платежа приостановлено до получения уведомления с результатом со стороны платёжной системы. В зависимости от результата на стороне платёжной системы платёж переводится в статус В рамках проведения одного платежа может использоваться |
Промежуточное состояние |
awaiting customer action |
Проведение платежа приостановлено до выполнения необходимых действий пользователем со стороны платёжной системы (в соответствии со спецификой платёжного метода). В зависимости от результата этих действий платёж переводится в статус В рамках проведения одного платежа может использоваться |
Промежуточное состояние |
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 Secure — 3ds_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 |
Операция выполнена | Конечное состояние |
Дополнительные материалы
При работе с одностадийными оплатами могут быть полезны следующие материалы:
- Организация взаимодействия — раздел с общей информацией о взаимодействии с платёжной платформой через Gate.
- Оплата в одну стадию — раздел с подробной информацией о проведении одностадийных оплат с использованием платёжных карт.
- Альтернативные платежные методы — раздел с подробной информацией о проведении одностадийных оплат с использованием альтернативных платёжных инструментов.
- Оповещения — раздел с информацией об оповещениях и работе с ними.
- Информация о выполнении операций — раздел с информацией о кодах ошибок, используемых в платёжной платформе.