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 2 Next »

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

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

 

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

  платеж с регистраций РП 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 переданным при первом вызове РП.

  • No labels