Разовая оплата в две стадии

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

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

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

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

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

Этот вариант может быть актуален, когда необходимо гарантировать возможность последующего списания или отмены блокировки суммы в зависимости от ситуации (например, при бронировании номера в отеле).

С помощью Payment Page можно выполнить первую стадию такой оплаты — блокировку средств пользователя. Для выполнения второй стадии — списания заблокированных средств или отмены блокировки — необходимо использовать интерфейс Gate или Dashboard либо настроить автоматическое выполнение этой стадии по истечении заданного времени.

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

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

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

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

Вторая стадия такой оплаты может быть инициирована по запросу со стороны веб-сервиса мерчанта или автоматически через заданный период на стороне платёжной платформы.

Чтобы инициировать вторую стадию по запросу, следует использовать интерфейс Gate или Dashboard. Для выполнения этой стадии используется одна из следующих операций:

capture, если выполняется списание заблокированных средств;
cancel, если выполняется отмена блокировки средств.

Подробную информацию об автоматическом инициировании второй стадии необходимо уточнять у курирующего менеджера.

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

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

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

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

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

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

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

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

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

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

Статусы операций capture и cancel

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

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

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

Статусы операций reversal и refund совпадают со статусами операций capture и cancel.

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

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

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