Page tree

Versions Compared

Key

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

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

Warning
Двухэтапные платежи по рекуррентам в МПС МИР запрещены!

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

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

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

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

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

Версия API

ЗначениеПримеры/примечания
order_id1.0, 2.0Идентификатор заказа, длина 6-20 символов.

123456 (минимально 6 знаков)


Expand
titleУже существует заказ с order_id XXXXX. Старый номер XXXXXXXXX

Существует механизм проверки номера заказа (order_id) на уникальность. Это не ошибка. Предупреждение, которое вы видите в таких случаях - результат этой проверки.
Ссылка или кнопка - это генератор. Каждый переход по ней - это попытка создать новую транзакцию с тем номером, который ссылка в данный момент передаёт. Передача одинакового номера заказа из админки магазина (CMS) приводит к тому же результату.

Пример ссылки, содержащей номер заказа:
https://partner.rficb.ru/alba/input/?name=Rent_hall&cost=15200&key=Agl%2FskVOgsU6ZizcKvXjIlWhNJPyYri9x0J%2BY9ex6C0%3D&default_email=&order_id=192032

Пример алгоритма получения предупреждения:

  1. Первый клик создал транзакцию 3950000001 с номером заказа 192032. Оплата не состоялась, плательщик закрыл браузер.
  2. Через некоторое время плательщик нажал на эту ссылку снова. Банковский шлюз попытался создать транзакцию 3950000002 с номером заказа 192032.
  3. Предупреждение. Существование двух разных транзакций с одинаковым номером невозможно!

Если вы хотите избежать такого поведения, передавайте новый номер заказа на каждый клик по кнопке из корзины или ссылке. Если вы продолжаете получать предупреждение "Уже существует заказ с order_id XXXXX. Старый номер XXXXXXXXX", значит ваш магазин по каждому клику присылает одно и то же. Вы можете убедиться в существовании транзакции с указанным в предупреждении "старым" номером, проверив раздел "Отчёты".

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 + secret_key(УСТАРЕШЕЕ)
Представляется в виде шестнадцатеричной строки. Поле secret_key это секретный ключ сервиса (устанавливается в ЛК). Данный параметр обязателен для рекуррентных операций.

После получения корректного запроса Банк инициирует первый рекуррентный платеж.
По результатам платежа, Банк перенаправляет пользователя к партнеру и информирует плательщика на указанный e-mail ссылкой для отписки (деактивации) РП.
Банк через асинхронную нотификацию информирует партнера о успешной активации РП и оплате первой транзакции. Дополнительно к расширенной нотификации command=success передаются поля: recurrent_order_id и card с маскированным номером карты. См. описание нотификаций.

Если плательщик отказался от сохранения карты в нотификациях параметр recurrent_order_id будет отсутствовать.

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

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

Имя параметраВерсия APIЗначениеПримеры/примечания
payment_type1.0, 2.0Способ оплаты.spg или spg_test
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Идентификатор сервиса, обязательно для версии 2.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 + secret_key

Представляется в виде шестнадцатеричной строки. Поле secret_key это секретный ключ сервиса (устанавливается в ЛК). Данный параметр обязателен



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

Описание результата операций с 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_key. Где secret_key это секретный ключ сервиса.

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

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

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

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