Повторяемая оплата с автоматическими списаниями
Помимо этой статьи для работы с повторяемыми оплатами могут быть полезны:
- статья Регистрация повторяемых оплат с описанием того, как регистрировать повторяемые оплаты через Payment Page и какие запросы и оповещения при этом актуальны в случае прямого использования платёжных карт;
- статьи раздела Платёжные методы с описанием того, как регистрировать повторяемые оплаты через Payment Page при работе с различными платёжными методами и какие запросы и оповещения могут быть актуальны при этом.
Общая информация
Повторяемая оплата с автоматическими списаниями — это тип платежа, в рамках которого на основании одного исходного запроса осуществляется серия переводов денежных средств от пользователя к мерчанту с использованием сохранённых платёжных данных и без подтверждения подлинности платёжного инструмента пользователя (такого, как ввод кода проверки подлинности карты).
Этот вариант может быть актуален, когда в рамках обслуживания пользователя необходимо проводить оплаты с использованием одного и того же платёжного инструмента с привязкой к графику и к сумме платежа (например, при «подписке» на сервис с периодической оплатой). При использовании повторяемых оплат с автоматическими списаниями у пользователя и мерчанта может быть уверенность в своевременном проведении серии оплат без участия с их стороны.
С помощью Payment Page можно выполнять регистрацию повторяемых оплат, в том числе регулярных оплат, в рамках которых каждое списание автоматически инициируется на стороне платёжной платформы.
Модель проведения
Для регистрации повторяемой оплаты с автоматическими списаниями при помощи Payment Page предварительно требуется провести разовую оплату или проверку действительности платёжного инструмента с сохранением в платформе платёжных данных пользователя и с указанием нужного типа повторяемой оплаты. Список параметров, которые требуется передать для последующего проведения повторяемой оплаты, может отличаться в зависимости от используемого платёжного метода (подробнее — Методы).
Зарегистрированную повторяемую оплату с автоматическими списаниями — при условии, что при её регистрации были переданы необходимые параметры — инициировать не нужно: все списания инициируются автоматически на стороне платёжной платформы. Для выполнения каждого списания используется отдельная операция recurring. Так как такая оплата инициируется автоматически, дополнение информации о платеже не выполняется.
При необходимости для зарегистрированной повторяемой оплаты можно обновить условия выполнения списаний в рамках повторяемой оплаты или отменить их дальнейшее выполнение с помощью интерфейса Gate. Для выполнения этих действий в зависимости от используемого платёжного метода отдельные операции могут не формироваться или могут формироваться операции recurring_update и recurring_cancel соответственно.
Если для платёжного метода, с использованием которого была проведена повторяемая оплата, поддерживается проведение возвратов, то после выполнения хотя бы одного списания в рамках этой оплаты по ней можно выполнить возврат средств пользователю. Чтобы инициировать его выполнение, следует использовать интерфейсы Gate или Dashboard. При этом используется операция refund.
Рис.: Диаграмма состояний повторяемой оплаты с автоматическими списаниями
Далее в рамках данного раздела представлена информация о возможных статусах повторяемой оплаты с автоматическими списаниями и связанных с ней операций. Более подробную информацию о регистрации и проведении повторяемой оплаты можно найти в разделе Регистрация повторяемых оплат, а о нюансах проведения такой оплаты в зависимости от используемого платёжного метода — в разделе Методы.
Статусы платежа
При проведении повторяемой оплаты с автоматическими списаниями могут использоваться следующие статусы.
error |
Проведение платежа не инициировано из-за ошибки, возникшей при проверке принятого в платёжной платформе запроса | Конечное состояние. Допускается повторное инициирование этого платежа |
processing |
Выполняется очередное списание в рамках платежа | Промежуточное состояние |
awaiting clarification |
Не используется при проведении повторяемых оплат с автоматическими списаниями при помощи Payment Page | Промежуточное состояние |
sсheduled recurring processing |
Ожидаются дальнейшие списания средств пользователя в рамках платежа | Промежуточное состояние |
decline |
Платёж отклонён | Конечное состояние |
success |
Платёж проведён: все списания в рамках платежа выполнены | Конечное состояние. Дополнительно допускается проведение возврата |
partially refunded |
Сумма платежа частично возвращена, при этом все списания в рамках платежа выполнены | Конечное состояние. Дополнительно допускается отмена возврата |
refunded |
Сумма платежа полностью возвращена, при этом все списания в рамках платежа выполнены | Конечное состояние. Дополнительно допускается отмена возврата |
Статусы операций recurring
При выполнении операции recurring могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
awaiting clarification |
Не используется при проведении повторяемых оплат с автоматическими списаниями при помощи Payment Page | Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операции recurring_update и recurring_cancel
При выполнении операций recurring_update и recurring_cancel могут использоваться следующие статусы.
processing |
Операция выполняется | Промежуточное состояние |
decline |
Операция отклонена | Конечное состояние |
success |
Операция выполнена | Конечное состояние |
Статусы операции refund
Статусы операции refund совпадают со статусами операции recurring.
Дополнительные материалы
При работе повторяемыми оплатами могут быть полезны следующие материалы:
- Методы — раздел с подробной информацией о нюансах проведения регулярных оплат в зависимости от используемого платёжного метода.
- Возвраты средств после оплат — раздел с информацией о выполнении возвратов через интерфейс Gate.
- Dashboard — раздел с информацией о работе с интерфейсом Dashboard.
- Оповещения — раздел с информацией об оповещениях и работе с ними.
- Информация о выполнении операций — раздел с информацией о кодах ошибок, используемых в платёжной платформе.