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

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

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

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

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

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

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

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

Сумму средств, заблокированную в результате выполнения этой стадии, можно изменить как до выполнения второй стадии, так и одновременно с её выполнением. Для увеличения суммы до инициирования второй стадии оплаты следует отправить запрос incremental, а для уменьшения — запрос cancel.

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

Чтобы инициировать вторую стадию двухстадийной оплаты, следует отправить в платформу один из следующих запросов:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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