# Разовая оплата в две стадии {#ru_platform_dms_model}

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

## Общая информация {#section_zvh_1rr_whb .section}

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

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

## Схема проведения {#section_ajd_brr_whb .section}

Чтобы инициировать *первую стадию* оплаты, следуетотправить в платформу запрос категории `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`, если возврат инициируется до закрытия [операционного дня](ru_glossary.md), вне зависимости от суммы оплаты для карт платёжной системы Mastercard и при условии возврата всей суммы оплаты для карт других платёжных систем;
-   `refund`, если возврат инициируется для карт любых платёжных систем после закрытия [операционного дня](ru_glossary.md) и вне зависимости от суммы, а также до закрытия операционного дня при условии возврата части суммы оплаты для карт всех платёжных систем, кроме Mastercard.

![](images/payment%20model/ru_gate_payment_model_3.svg)



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

## Статусы платежа {#section_n4r_brr_whb .section}

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

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

## Статусы операции auth {#section_h3k_crr_whb .section}

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

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

## Статусы операции incremental {#section_kly_zw4_nnb .section}

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

|`decline`|Операция отклонена|*Конечное состояние*|
|`success`|Операция выполнена|*Конечное состояние*|

## Статусы операций capture и cancel {#section_wxn_gsr_whb .section}

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

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

## Статусы операций reversal и refund {#section_zfx_crr_whb .section}

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

**На уровень выше:**[Проведение платежей](ru_platform_payment_model.md)