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

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

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

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

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

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

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

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

До проведения повторяемой оплаты требуется провести первоначальный платёж — разовую оплату или проверку действительности платёжного инструмента — с сохранением в платформе платёжных данных пользователя и с указанием типа повторяемой оплаты. Для этого в запросе на первоначальный платёж должен быть передан объект recurring с указанием параметров register и type.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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