Рекуррентные платежи

Рекуррентные платежи — это регулярное списание денег с сохранённой карты покупателя без необходимости каждый раз подтверждать платёж. К ним относятся регулярные подписки, автоплатежи или привязка карты в приложении для последующих покупок. Рассказываем, как настроить рекуррентные платежи в интернет-эквайринге LIFE PAY.

info

Принимать рекуррентные платежи могут не все пользователи. Чтобы подать заявку на подключение рекуррентных платежей, обратитесь к вашему персональному менеджеру.

Рекуррентные платежи могут списываться по графику или по повторяющемуся запросу от покупателя. Рассмотрим разницу на примере.

Василий разработал онлайн-библиотеку для смартфона и опубликовал приложение в магазине. Подписка стоит 200 рублей в месяц. Покупатель скачивает приложение, указывает данные карты, а дальше стоимость подписки списывается с карты каждый месяц. Такие платежи списываются по графику. Продавец настраивает расписание при первом платеже, а после сумма списывается автоматически по этому расписанию — продавцу не надо ничего дополнительно делать.

Теперь предположим, что Василий написал не простое приложение, а сервис вызова такси. Покупатель добавляет данные карты, но дальше вместо регулярной подписки он оплачивает каждую поездку. Такие платежи списываются по событию. Общее с первым примером здесь то, что транзакцию не нужно подтверждать каждый раз. Но есть и отличие: платёж инициирует покупатель. Регулярного графика нет: понадобилось такси — заплатил и поехал.

Настроить платёж по графику

Чтобы добавить рекуррентный платёж, используйте обычный POST-запрос выставления счёта:

https://api-ecom.life-pay.ru/v1/invoices

Описание запроса

Вам нужно, чтобы списание происходило регулярно. Для этого передайте признак рекуррентного платежа is_recurrent=true и добавьте объект recurrent_schedule, имеющий следующие поля:

• next_recurrent_date — дата следующего платежа.
• period — длительность периода списаний. Возможные значения: day, week, month, quarter, year. По умолчанию используется month.
• period_count — количество счётных единиц периода. По умолчанию 1.

next_recurrent_date	period	period_count	Результат
23.01.2023	day	3	Первый платёж спишется 23.01.2023; далее платежи будут списываться раз в 3 дня: 26.01.2023, 29.01.2023, 01.02.2023, 04.02.2023 и т. д.
23.01.2023	week	1	Первый платёж спишется 23.01.2023; далее платежи будут списываться раз в неделю: 30.01.2023, 06.02.2023, 13.02.2023 и т. д.
23.01.2023	month	1	Первый платёж спишется 23.01.2023; далее платежи будут списываться раз в месяц: 23.02.2023, 23.03.2023, 23.04.2023 и т. д.
31.01.2023	month	1	Первый платёж спишется 31.01.2023; далее платежи будут списываться раз в месяц: 28.02.2023, 31.03.2023, 30.04.2023 и т. д.

note

График списаний настраивается в LIFE PAY Online API. Настраивать его на стороне своего сервиса не нужно.

Если хотите установить пробный период или скидку на отдельные платежи, используйте необязательные параметры recurrent_amount и schedule.

"recurrent_amount": 250,
"schedule": [
  {
    "amount": "0",
    "iteration": 1
  },
  {
    "amount": "0",
    "iteration": 2
  }
],
...

В приведённом примере подписка на приложение стоит 250 рублей, но в первой и второй итерации с покупателя списывается 0 рублей.

• recurrent_amount — сумма рекуррентного платежа. Если указана, не может быть равна 0.
• amount — сумма платежа на конкретной итерации рекуррента. Может быть равна 0.

Создать платёж по событию

Если нужно, чтобы клиент сам мог запрашивать и оплачивать повторные счета без необходимости каждый раз подтверждать транзакцию, сначала выставьте обычный счёт — отправьте POST-запрос по адресу:

https://api-ecom.life-pay.ru/v1/invoices

Описание запроса

В теле запроса передайте признак рекуррентного платежа is_recurrent=true. Объект recurrent_schedule передавать не нужно, иначе на запросы дальнейших платежей сервис будет возвращать ошибку, так как расписание платежей уже установлено.

Чтобы запросить новое списание с карты покупателя, отправьте POST-запрос по адресу:

https://api-ecom.life-pay.ru/v1/services/{service_id}/recurrents/{recurrent_order_id}/charges

• service_id — идентификатор вашего сервиса.
• recurrent_order_id — order_id исходного счёта.

Описание запроса

Отменить рекуррентный платёж

Чтобы отменить рекуррентный платёж, в том числе отозвать согласие на платежи по событию, отправьте DEL-запрос по адресу:

https://api-ecom.life-pay.ru/v1/services/{service_id}/recurrents/{recurrent_order_id}

• service_id — идентификатор вашего магазина.
• recurrent_order_id — order_id исходного счёта.

Описание запроса

Сопровождение покупателя

Интернет-эквайринг LIFE PAY отправляет покупателю уведомления на почту:

• об успешном первом платеже,
• о том, что платёж не прошёл,
• о предстоящем платеже,
• об отмене платежа.