Инструменты страницы

Рекуррентные платежи и автоплатежи по связке

Термины и определения

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

Рекуррентный платёж, автоплатёж - списание денежных средств со счёта банковской карты плательщика, не требующее подтверждения плательщика.

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

Описание функциональности рекуррентных и автоплатежей по связке

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

В сценарии автоплатежей оплата происходит через метод paymentOrderBinding и состоит из двух серий запросов:

  • первоначальный запрос;
  • запрос для проведения автоплатежа.

В сценарии реккурентных платежей происходит оплата через метод recurrentPayment и состоит из двух серий запроса:

  • первоначальный запрос;
  • запрос для проведения реккурентного платежа.

Для рекуррентных платежей через SberPay возможно использование только одностадийной оплаты. При этом для обычных связок двухстадийная оплата возможна.

Сценарий проведения первоначального платежа

1. Пользователь выбирает товар или услугу на ресурсе продавца и выбирает способ оплаты банковской картой.
2.

В сторону платёжного шлюза направляется запрос регистрации заказа с обязательной передачей идентификатора Клиента в системе магазина. Параметры рекуррентного платежа передаются в блоке дополнительных параметров params.

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

  • recurringFrequency – период рекуррентных платежей в днях (натуральное число в пределах от 1 до 28).
  • recurringExpiry – дата прекращения действия рекуррентных платежей (формат YYYYMMDD).

Дополнительные параметры recurringFrequency и recurringExpiry являются информационными параметрами для передачи в МПС, календарь списаний по этим данным не формируется. Таким образом, в дальнейшем мерчант самостоятельно отслеживает, когда необходимо инициировать очередной рекуррентный платёж, а также когда рекуррентные платежи следует прекратить. Пример: 

additionalParameters={recurringFrequency=1, recurringExpiry=21211229}


Запросы регистрации заказа для одностадийных и двухстадийных платежей:

3. В ответ платёжный шлюз возвращает уникальный идентификатор заказа в платёжной системе и URL платёжной формы.
4. Магазин перенаправляет Клиента на форму оплаты, где Клиент выбирает оплату посредством СБОЛ.
5. Клиент совершает оплату внутри СБОЛа.
6. После проведения оплаты платёжный шлюз перенаправляет клиента на URL-адрес возврата (указанный магазином в запросе на регистрацию).
7.

Продавец запрашивает у платёжного шлюза статус оплаты заказа, используя уникальный идентификатор заказа, полученный при регистрации заказа в параметре orderId:

8. В результате успешного проведения первоначального платежа будет создана связка в платёжном шлюзе bindingId, т.е. реквизиты карты, которая использовалась для оплаты, будут сохранены и привязаны к идентификатору Клиента.

Сценарий проведения автоплатежа

1.

В сторону платёжного шлюза направляется запрос регистрации заказа с обязательной передачей идентификатора Клиента в системе магазина. Параметр автоплатежа AUTO_PAYMENT передаётся в блоке features.

Запросы регистрации заказа:

2. В ответ платёжный шлюз среди прочего возвращает уникальный идентификатор заказа в платёжной системе
3.

В сторону платёжного шлюза направляется запрос оплаты по связке:

4. Платёжный шлюз списывает деньги со счёта Клиента.
5.

Продавец запрашивает у платёжного шлюза статус оплаты заказа, используя уникальный идентификатор заказа, полученный при регистрации заказа в параметре orderId:

6. Платёжный шлюз возвращает статус оплаты.

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

1.

В сторону платёжного шлюза направляется запрос регистрации заказа recurrentPayment с обязательной передачей идентификатора Клиента в системе магазина, а также суммы платежа.

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

Уведомление мерчанта о событиях со связками SberPay

Обладая определенными пермиссиями и настройками, мерчант может получать callback-уведомление о внесении изменения в соответствующую связку SberPay: если связка была активирована/деактивирована, либо были изменены её данные.

Алгоритм обработки данного уведомления остается таким же, как описано в разделе о callback-уведомлениях.