Данная опция доступна только ТСП согласовавших предоставление рекуррентных платежей при подключении к системе. При подключении РП необходимо подготовить работу вашей системы для обработки сообщений описанных в разделе “Получение дополнительных параметров”
Регистрация рекуррентного платежа
Рекуррентный платеж (РП) состоит из двух операций:
- платеж с регистраций РП recurrent_type=first
- РП по требованию recurrent_type=next
Для регистрации рекуррентного платежа отправляется обычный запрос на адрес https://partner.rficb.ru/alba/input/ описанный в таблицах №1 и №2 плюс дополнительные параметры:
| Имя параметра | Значение | Примеры/примечания |
| order_id | Идентификатор заказа, длина 6-20 символов. | 123456 (минимально 6 знаков) |
| payment_type | тип оплаты, на который должен быть отправлен плательщик | spg spg_test (для тестов) |
| recurrent_type | Указание что платеж является рекуррентным, если значение равно:
| Если значение = ”first” то обязательными являются поля: email, order_id, recurrent_comment, recurrent_url, recurrent_period Если значение = ”next” то обязательными являются поля: |
| recurrent_comment | Текстовое описание за что производится регистрация РП | Текстовое поле. Передается опционально. |
| recurrent_url | Ссылка на подробное описание правил предоставления рекуррентного платежа | Пример: http://example.com/rules |
| recurrent_order_id | order_id передаваемый партнеру в случае регистрации РП. Не указывается если recurrent_type=first. Длина 6-20 символов. | 123456 (минимально 6 знаков) |
| recurrent_period | Период через который происходит очередное списание | На данный момент допустимо только значение: byrequest Необходимо передавать только в случае recurrent_type=first |
| check | Подпись версии 2.0 – электронная подпись запроса. См. приложение №1 | Обязательна передача параметра version=’2.0’ и service_id. Параметр key в данном случае не требуется. |
check (Устаревшее) | MD5 хеш от параметров: key + cost + name + email + order_id + comment + payment_type + recurrent_comment +recurrent_url + recurrent_type + recurrent_order_id + recurrent_period + secrent_key | (УСТАРЕШЕЕ) Представляется в виде шестнадцатеричной строки. Поле secret_key это секретный ключ сервиса (устанавливается в ЛК). Данный параметр обязателен для рекуррентных операций |
После получения корректного запроса Банк инициирует первый рекуррентный платеж.
По результатам платежа, Банк перенаправляет пользователя к партнеру и информирует плательщика на указанный e-mail ссылкой для отписки (деактивации) РП.
Банк через асинхронную нотификацию информирует партнера о успешной активации РП и оплате первой транзакции. Дополнительно к расширенной нотификации передаются поля: recurrent_type со значением “next“, card с маскированным номером карты.
Проведение второго и последующих платежей в РП (синхронная операция)
Партнер формует запрос на https://partner.rficb.ru/alba/input/ с указанием основного набора параметров плюс:
| Имя параметра | Значение | Примеры/примечания |
| recurrent_type | “next”, для повторных РП. | “next” |
| recurrent_order_id | ссылка на order_id первого РП, необходимо передавать order_id указанный при регистрации первого РП. Длина 6-20 символов. | 100001 |
| background | Параметр указывающий на то, что запрос выполняется в фоновом режиме | 1 |
| check | Подпись версии 2.0 – электронная подпись запроса. См. приложение №1 | Обязательна передача параметра version=’2.0’ и service_id. Параметр key в данном случае не требуется. |
(устаревшее) check | (устаревшее) MD5 хеш от параметров: key + cost + name + email + order_id + comment + payment_type + recurrent_comment + recurrent_url +recurrent_type + recurrent_order_id + recurrent_period + secrent_key | Представляется в виде шестнадцатеричной строки. Поле secret_key это секретный ключ сервиса (устанавливается в ЛК). Данный параметр обязателен |
При параметре recurrent_type = “next” Банк не формирует форму выбора типа платежа, а на основании recurrent_order_id определяет предыдущий типа платежа. Использование payment_type может быть не допустимо, если первая транзакция вызывалась без него.
Плательщик или система ТСП так же не переправляется на форму ввода карточных данных, а ожидает получения результатов операции оплаты через обработчик событий. Результат оплаты стандартно возвращается партнеру. Дополнительно к стандартной нотификации передаются поля: recurrent_type со значением “next”, card с маскированным номером карты и recurrent_order_id с order_id переданным в результате первого РП.
Описание результата операций с background=1.
Отмена рекуррентного платежа (синхронная операция)
Для прекращения действия рекуррентного платежа необходимо отправить запрос с параметрами указанными ниже на URL: https://partner.rficb.ru/alba/recurrent_change/
| Имя параметра | Назначение |
| operation | Действие над рекуррентом, должно быть “cancel” |
| order_id | order_id переданный при регистрации РП |
| service_id | Идентификатор сервиса |
| check | Подпись версии 2.0 – электронная подпись запроса. См. приложение №1 |
(устаревшее) check | (устаревшее) MD5 хеш от параметров: operation + service_id + order_id + secret. Где secret это секретный ключ сервиса. |
Нотификация о прекращении действия рекуррентного платежа
Если держатель карты отменяет подписку на рекуррентные платежи, то приходит стандартная нотификация со значением command=recurrent_cancel, а так же параметром recurrent_order_id с order_id переданным при первом вызове РП.