Повторяемая оплата со списаниями по запросам

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

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

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

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

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

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

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

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

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

Зарегистрированную повторяемую оплату со списаниями по запросам можно инициировать, указав в параметрах вызова платёжной формы режим работы purchase и дополнительные параметры, необходимые для проведения повторяемой оплаты с использованием конкретного платёжного метода, например идентификатор пользователя (подробнее об инициировании повторяемых оплат — в разделе Методы). После открытия платёжной формы пользователю необходимо выбрать для проведения оплаты тот платёжный инструмент, для которого зарегистрирована повторяемая оплата, и подтвердить своё согласие на проведение платежа. Подтверждать подлинность платёжного инструмента при этом не требуется. При получении согласия пользователя на проведение платежа в платёжную платформу направляется запрос, для выполнения которого в платформе формируется операция sale.

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

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

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

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

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

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

error Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого в платёжной платформе запроса Конечное состояние. Допускается повторное инициирование этого платежа
processing Платёж проводится Промежуточное состояние
awaiting clarification Проведение платежа приостановлено до получения дополнительной информации от пользователя. Если такая информация не получена в течение 30 минут, платёж переводится в статус decline Промежуточное состояние
decline Платёж отклонён Конечное состояние
success Платёж проведён Конечное состояние. Дополнительно допускается проведение возврата
reversed Сумма платежа полностью возвращена до закрытия бизнес-дня, в котором он был проведён Конечное состояние. Дополнительно допускается отмена возврата
partially refunded Сумма платежа частично возвращена Конечное состояние. Дополнительно допускается отмена возврата
refunded Сумма платежа полностью возвращена после закрытия бизнес-дня, в котором он был проведён. Осуществлён один полный возврат суммы платежа или несколько частичных, в совокупности составляющих исходную сумму Конечное состояние. Дополнительно допускается отмена возврата

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

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

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

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

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

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

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

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