Разовая оплата в одну стадию | Документация ECOMMPAY

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

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

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

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

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

Аутентификация пользователя с использованием протокола 3‑D Secure. При работе через Gate для выполнения такой аутентификации со стороны веб-сервиса требуется принять соответствующее оповещение и выполнить необходимые действия, а при работе через Payment Page все необходимые для этого действия выполняются без участия веб-сервиса.
Аутентификация пользователя со стороны платёжной системы по инициативе мерчанта. При работе через Gate для выполнения такой аутентификации со стороны веб-сервиса требуется принять соответствующее оповещение и выполнить необходимые действия, а при работе через Payment Page все необходимые для этого действия выполняются без участия веб-сервиса.
Дополнение информации о платеже для какой-либо из сторон, участвующих в проведении платежа. При работе через Gate для дополнения информации со стороны веб-сервиса требуется принять соответствующее оповещение и отправить запрос с недостающей информацией, а при работе через Payment Page все необходимые для этого действия выполняются без участия веб-сервиса.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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