# Повторяемая оплата со списаниями по запросам {#ru_platform_recurring_model}

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

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

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

Этот вариант может быть актуален, когда в рамках обслуживания пользователя необходимо неоднократно проводить оплаты с использованием одного и того же платёжного инструмента без привязки к графику или сумме платежа \(например, при предоставлении услуг такси\). Для пользователя такие оплаты могут быть удобны тем, что с его стороны нет необходимости каждый раз вводить одни и те же платёжные данные и подтверждать подлинность платёжного инструмента.

В платёжной платформе поддерживаются следующие категории повторяемых оплат со списаниями по запросам:

-   *Экспресс-оплаты*. Списания в рамках таких оплат инициируются пользователем и выполняются без привязки к расписанию или сумме платежа. Например, пользователь онлайн-кинотеатра может оплатить прокат одного или нескольких фильмов с использованием сохранённых данных карты.
-   *Автооплаты*. Списания в рамках таких оплат инициируются мерчантом и выполняются нерегулярно или на различные суммы. Например, когда остаток средств на счёте пользователя становится ниже заданного, выполняется списание средств с его карты для пополнения счёта.

При использовании Gate можнорегистрировать и проводить любые повторяемые оплаты, а при использовании Payment Page доступна регистрация любых повторяемых оплат и проведение *экспресс-оплат* \(OneClick\)при использовании некоторых платёжных методов.

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

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

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

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

Для проведения повторяемой оплаты со списаниями по запросам в редких случаях может требоваться отправка дополнительного запроса, если необходимо *дополнение информации о платеже* для какой-либо из сторон, участвующих в проведении платежа \(например, предоставление в платёжную систему адреса держателя карты, не переданного в исходном запросе\). При использовании Gate в таких случаях от платформы к веб-сервису отправляется оповещение с названиями параметров для уточнения и проведение платежа в платформе приостанавливается до получения от веб-сервиса запроса с необходимой информацией — `clarification`, — а при использовании Payment Page все действия выполняются без участия веб-сервиса мерчанта.

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

-   `reversal`, если возврат инициируется до закрытия [операционного дня](ru_glossary.md#), вне зависимости от суммы оплаты для карт платёжной системы Mastercard и при условии возврата всей суммы оплаты для карт других платёжных систем;
-   `refund`, если возврат инициируется для карт любых платёжных систем после закрытия [операционного дня](ru_glossary.md#) и вне зависимости от суммы, а также до закрытия операционного дня при условии возврата части суммы оплаты для карт всех платёжных систем, кроме Mastercard.

![](images/payment%20model/ru_gate_payment_model_4.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 clarification`|Проведение платежа приостановлено до получения требуемой дополнительной информации. Если такая информация не получена в течение 30 минут, платёж переводится в статус `decline`|*Промежуточное состояние*|
|`decline`|Платёж отклонён|*Конечное состояние*|
|`success`|Платёж проведён|*Конечное состояние. Дополнительно допускается проведение возврата*|
|`reversed`|Сумма платежа полностью возвращена до закрытия бизнес-дня, в котором он был проведён|*Конечное состояние. Дополнительно допускается отмена возврата*|
|`partially refunded`|Сумма платежа частично возвращена|*Конечное состояние. Дополнительно допускается отмена возврата*|
|`refunded`|Сумма платежа полностью возвращена после закрытия операционного дня, в котором он был проведён. Осуществлён один полный возврат суммы платежа или несколько частичных, в совокупности составляющих исходную сумму|*Конечное состояние. Дополнительно допускается отмена возврата*|

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

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

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

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

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

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