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

Notice: Эта статья посвящена тому, как проводятся разовые оплаты в одну стадию в платёжной платформе ecommpay, какие операции при этом используются и как меняются статусы этих платежей и операций.

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

статья Оплата в одну стадию с описанием того, как проводить разовые оплаты в одну стадию через Gate и какие запросы и оповещения при этом актуальны в случае прямого использования платёжных карт;
статьи раздела Платёжные методы с описанием того, как проводить разовые оплаты в одну стадию через Gate при работе с различными платёжными методами и какие запросы и оповещения могут быть актуальны при этом.

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

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

Модель проведения

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

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

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

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

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

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

Также операция reversal может инициироваться в тех случаях, когда оплате после подтверждения со стороны платёжной системы или провайдера присвоен статус success, но зачислить средства получателю по каким-либо причинам невозможно.

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

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

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

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


`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`	Проведение платежа приостановлено до получения уведомления с результатом со стороны платёжной системы. В зависимости от результата на стороне платёжной системы платёж переводится в статус `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 confirmation`	Проведение платежа приостановлено до получения со стороны платёжной системы или провайдера уведомления о зачислении средств получателю	Промежуточное состояние
`awaiting customer`	Проведение платежа приостановлено до получения результата повторных попыток со стороны пользователя. При успешной повторной попытке платёж переводится в статус `success`, а при истечении числа безуспешных попыток — в статус `decline` (подробнее — в разделе Повторные попытки проведения платежей)	Промежуточное состояние
`decline`	Платёж отклонён	Конечное состояние
`success`	Платёж проведён	Конечное состояние. Дополнительно допускается проведение возврата
`partially refunded`	Сумма платежа частично возвращена	Конечное состояние. Дополнительно допускается отмена возврата
`refunded`	Сумма платежа полностью возвращена после закрытия бизнес-дня, в котором он был проведён. Осуществлён один полный возврат суммы платежа или несколько частичных, в совокупности составляющих исходную сумму	Конечное состояние. Дополнительно допускается отмена возврата
`partially reversed`	Сумма платежа частично возвращена	Конечное состояние
`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`	Операция выполнена	Конечное состояние

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

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


`processing`	Операция выполняется	Промежуточное состояние
`decline`	Операция отклонена	Конечное состояние
`success`	Операция выполнена	Конечное состояние

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

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


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

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

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

Организация взаимодействия — раздел с общей информацией о взаимодействии с платёжной платформой через Gate.
Оплата в одну стадию — раздел с подробной информацией о проведении одностадийных оплат с использованием платёжных карт.
Методы — раздел с подробной информацией о проведении одностадийных оплат с использованием альтернативных платёжных инструментов.
Оповещения — раздел с информацией об оповещениях и работе с ними.
Информация об операциях — раздел с информацией о кодах ошибок, используемых в платёжной платформе.