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

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

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

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

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

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

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

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

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

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

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

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

Если для платёжного метода, с использованием которого была проведена оплата, поддерживается проведение возвратов, то после проведения второй стадии разовой оплаты по этой оплате можно выполнить возврат средств пользователю. Чтобы инициировать его выполнение, следует использовать интерфейсы Gate или Dashboard (Old 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 Проведение платежа приостановлено до получения результата повторных попыток со стороны пользователя. При успешной повторной попытке платёж переводится в статус success, а при истечении числа безуспешных попыток — в статус decline (подробнее — в разделе Проведение повторных оплат) Промежуточное состояние
awaiting capture Проведение платежа приостановлено до получения запроса на списание (capture) или на отмену предварительной блокировки средств (cancel) Промежуточное состояние
canceled Предварительная блокировка средств, выполненная по запросу auth, отменена Конечное состояние
decline Платёж отклонён Конечное состояние
success Платёж проведён Конечное состояние. Дополнительно допускается проведение возврата
reversed Сумма платежа полностью возвращена до закрытия бизнес-дня, в котором он был проведён Конечное состояние. Дополнительно допускается отмена возврата
partially paid Платеж с разбиением суммы частично проведен по запросу capture Конечное состояние. Дополнительно допускается отмена возврата
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.

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

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