Skip to main content
Version: LIFE PAY Online 1.0

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

Рекуррентные платежи — это регулярное списание денег с сохранённой карты покупателя без необходимости каждый раз подтверждать платёж. К ним относятся регулярные подписки, автоплатежи или привязка карты в приложении для последующих покупок. Рассказываем, как настроить рекуррентные платежи в интернет-эквайринге 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_dateperiodperiod_countРезультат
23.01.2023day3Первый платёж спишется 23.01.2023; далее платежи будут списываться раз в 3 дня: 26.01.2023, 29.01.2023, 01.02.2023, 04.02.2023 и т. д.
23.01.2023week1Первый платёж спишется 23.01.2023; далее платежи будут списываться раз в неделю: 30.01.2023, 06.02.2023, 13.02.2023 и т. д.
23.01.2023month1Первый платёж спишется 23.01.2023; далее платежи будут списываться раз в месяц: 23.02.2023, 23.03.2023, 23.04.2023 и т. д.
31.01.2023month1Первый платёж спишется 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_idorder_id исходного счёта.

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

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

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

https://api-ecom.life-pay.ru/v1/services/{service_id}/recurrents/{recurrent_order_id}
  • service_id — идентификатор вашего магазина.
  • recurrent_order_idorder_id исходного счёта.

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

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

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

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