Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 21 Next »

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

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

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

  • платеж с регистраций РП 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Идентификатор сервиса, обязательно для версии 1.0.121233
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”, 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.

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

 

  • No labels