Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

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

  • платеж с регистраций РП recurrent_type=first
  • РП по требованию recurrent_type=next

Для регистрации рекуррентного платежа отправляется обычный запрос на адрес https://partner.rficb.ru/alba/input/ описанный в таблицах №1 и №2 плюс дополнительные параметры:

Имя параметра

Версия API

ЗначениеПримеры/примечания
order_id1.0, 2.0Идентификатор заказа, длина 6-20 символов.123456 (минимально 6 знаков)
payment_type1.0, 2.0тип оплаты, на который должен быть отправлен плательщикspg

spg_test (для тестов)

recurrent_type1.0, 2.0Указание что платеж является рекуррентным, если

значение равно:

  • «first» – платеж и регистрация РП;
  • «next» – очередной РП;
  • все другие значения параметра – платеж не является РП.
Если значение = ”first” то обязательными являются поля:
email, order_idrecurrent_comment, recurrent_url, recurrent_period

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

recurrent_comment1.0, 2.0Текстовое описание за что производится регистрация РПТекстовое поле. Передается опционально.
recurrent_url1.0, 2.0Ссылка на подробное описание правил предоставления рекуррентного платежаПример: http://example.com/rules
recurrent_period1.0, 2.0Период через который происходит очередное списаниеНа данный момент допустимо только значение: byrequest

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

check2.0Подпись версии 2.0 – электронная подпись запроса. См. приложение №1

Обязательна передача параметра version=’2.0’ и service_id.

Параметр key в данном случае не требуется.

service_id2.0Идентификатор сервиса, обязательно для версии 2.0121233
version2.0Строка. Обязательно для установки версии API, отличного от 1.0. Если не задано используется версия API 1.0.2.0

check

(Устаревшее)

1.0MD5 хеш от параметров: 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 ссылкой для отписки (деактивации) РП.
Банк через асинхронную нотификацию информирует партнера о успешной активации РП и оплате первой транзакции. Дополнительно к расширенной нотификации command=success передаются поля: recurrent_order_id и card с маскированным номером карты. См. описание нотификаций.

Проведение второго и последующих платежей в РП (синхронная операция)

Партнер формует запрос на https://partner.rficb.ru/alba/input/ с указанием основного набора параметров плюс:

Имя параметраВерсия APIЗначениеПримеры/примечания
recurrent_type1.0, 2.0“next”, фикисрованное значение для повторных РП.next
recurrent_order_id1.0, 2.0Cсылка на order_id первого РП, необходимо передавать order_id указанный при регистрации первого РП. Длина 6-20 символов. Указывается только для recurrent_type=next123456 (минимально 6 знаков)
background1.0, 2.0Параметр указывающий на то, что запрос выполняется в фоновом режиме1
check2.0Подпись версии 2.0 – электронная подпись запроса. См. приложение №1

Обязательна передача параметра version=’2.0’ и service_id.

Параметр key в данном случае не требуется.

service_id2.0Идентификатор сервиса, обязательно для версии 1.0.121233
version2.0Строка. Обязательно для установки версии API, отличного от 1.0. Если не задано используется версия API 1.0.2.0

(устаревшее)

check

1.0

(устаревшее)

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”, order_id и card с маскированным номером карты и recurrent_order_id с order_id переданным в результате первого РП.См. описание нотификаций.

Описание результата операций с background=1.

Отмена рекуррентного платежа (синхронная операция)

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

Имя параметраВерсия APIНазначениеПримеры/примечания
operation1.0, 2.0Действие над рекуррентом, должно быть “cancel” 
order_id1.0, 2.0order_id переданный при регистрации РП 
service_id1.0, 2.0Идентификатор сервиса 
check2.0Подпись версии 2.0 – электронная подпись запроса. См. приложение №1 
version2.0Строка. Обязательно для установки версии API, отличного от 1.0. Если не задано используется версия API 1.0.2.0

(устаревшее)

check

1.0(устаревшее)
MD5 хеш от параметров: operation + service_id + order_id + secret. Где secret это секретный ключ сервиса.
 

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

Если держатель карты отменяет подписку на рекуррентные платежи, формируется нотификация command=recurrent_cancel.

Если срок действия карты истек, привязка карты аннулируется и формируется нотификация с значением command=recurrent_expire.

см. полный список расширенных нотификаций.