Данная опция доступна только ТСП согласовавших предоставление рекуррентных платежей при подключении к системе. При подключении РП необходимо подготовить работу вашей системы для обработки сообщений описанных в разделе “Получение дополнительных параметров

Регистрация рекуррентного платежа

 

Рекуррентный платеж (РП) состоит из двух операций:

  платеж с регистраций РП 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» – платеж и регистрация РП;

«next» – очередной РП;

все другие значения параметра – платеж не является РП.

Если значение = ”first” то обязательными являются поля:
email,

order_idrecurrent_comment,

recurrent_url, recurrent_period

Если значение = ”next” то обязательными являются поля:
background=1,

order_idrecurrent_order_id

recurrent_commentТекстовое описание за что производится регистрация РПТекстовое поле. Передается опционально.
recurrent_urlСсылка на подробное описание правил предоставления рекуррентного платежаПример: http://example.com/rules
recurrent_order_idorder_id передаваемый партнеру в случае регистрации РП. Не указывается если recurrent_type=first. Длина 6-20 символов.123456 (минимально 6 знаков)
recurrent_periodПериод через который происходит очередное списаниеНа данный момент допустимо только значение: byrequest

Необходимо передавать только в случае recurrent_type=first

version checkПодпись версии 2.0version=2.0
check – Электронная подпись запроса. См. приложение №1
checkMD5 хеш от параметров: 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
checkMD5 хеш от параметров: 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 переданным в результате первого РП.

Отмена рекуррентного платежа

Для прекращения действия рекуррентного платежа необходимо отправить запрос с параметрами указанными ниже на URL: https://partner.rficb.ru/alba/recurrent_change/

Имя параметраНазначение
operationДействие над рекуррентом, должно быть “cancel”
order_idorder_id переданный при регистрации РП
service_idИдентификатор сервиса
version checkПодпись версии 2.0
version=2.0
check – Электронная подпись запроса. См. приложение №1
check(УСТАРЕВШЕЕ)
MD5 хеш от параметров: operation + service_id + order_id + secret. Где secret это секретный ключ сервиса.

Нотификация о прекращении действия рекуррентного платежа

Если держатель карты отменяет подписку на рекуррентные платежи, то приходит стандартная нотификация со значением command=recurrent_cancel, а так же параметром recurrent_order_id с order_id переданным при первом вызове РП.