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

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

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

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

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

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

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

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

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

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

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

При необходимости можно выполнить обновление условий проведения повторяемой оплаты или её отмену. Для обновления условий следует отправить в платёжную платформу запрос категории update, а для отмены — запрос категории cancel. Для выполнения этих запросов могут использоваться операции recurring_update и recurring_cancel соответственно.

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

Рис. 1. Диаграмма состояний повторяемой оплаты с автоматическими списаниями

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

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

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

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

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

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

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

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

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

processing Операция выполняется Промежуточное состояние
decline Операция отклонена Конечное состояние
success Операция выполнена Конечное состояние

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

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

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

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