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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

`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 confirmation`	Проведение платежа приостановлено до получения со стороны платёжной системы или провайдера уведомления о зачислении средств получателю	Промежуточное состояние
`awaiting customer`	Проведение платежа приостановлено до получения со стороны пользователя данных, необходимых для выполнения повторной попытки. При получении этих данных платёж переводится в статус `processing`. При отказе пользователя или истечении времени на выполнение повторных попыток платёж переводится в статус `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`	Операция выполнена	Конечное состояние

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

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

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