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_id | 1.0, 2.0 | Идентификатор заказа, длина 6-20 символов. | 123456 (минимально 6 знаков)
| |||||
| payment_type | 1.0, 2.0 | тип оплаты, на который должен быть отправлен плательщик | spg spg_test (для тестов) | |||||
| recurrent_type | 1.0, 2.0 | Указание что платеж является рекуррентным, если значение равно:
| Если значение = ”first” то обязательными являются поля: email, |
...
| order_id, recurrent_comment, |
...
| recurrent_url, recurrent_period Если значение = ”next” то обязательными являются поля: |
...
order_id, recurrent_order_id | |||
| recurrent_comment | 1.0, 2.0 | Текстовое описание за что производится регистрация РП | Текстовое поле. Передается опционально. |
| recurrent_url | 1.0, 2.0 | Ссылка на подробное описание правил предоставления рекуррентного платежа | Пример: http://example.com/rules |
| recurrent_ |
...
| period | 1.0, 2.0 | Период через который происходит очередное списание | На данный момент допустимо только значение: byrequest Необходимо передавать только в случае recurrent_type=first |
...
| check |
...
| 2.0 |
...
| Подпись версии 2.0 |
...
| – |
...
| электронная подпись запроса. См. приложение №1 | Обязательна передача параметра version=’2.0’ и service_id. Параметр key в данном случае не требуется. | ||
| service_id | 2.0 | Идентификатор сервиса, обязательно для версии 2.0 | 121233 |
| version | 2.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 это секретный ключ сервиса (устанавливается в ЛК). Данный параметр обязателен для рекуррентных операций. |
После получения корректного запроса Банк инициирует первый рекуррентный платеж.
По результатам платежа, Банк перенаправляет пользователя к партнеру и информирует плательщика на указанный e-mail ссылкой для отписки (деактивации) РП.
Банк через асинхронную нотификацию информирует партнера о успешной активации РП и оплате первой транзакции. Дополнительно к расширенной нотификации
...
command=success передаются поля: recurrent_
...
order_id и card с маскированным номером карты. См. описание нотификаций.
Если плательщик отказался от сохранения карты в нотификациях параметр recurrent_order_id будет отсутствовать.
Проведение второго и последующих платежей в РП (синхронная операция)
Партнер формует запрос на https://partner.rficb.ru/alba/input/ с указанием основного набора параметров плюс:
| Имя параметра | Версия API | Значение | Примеры/примечания |
| payment_type | 1.0, 2.0 | Способ оплаты. | spg или spg_test |
| recurrent_type | 1.0, 2.0 | “next”, фикисрованное значение для повторных РП. |
...
| “next” |
| recurrent_order_id |
...
| 1.0, 2.0 | Cсылка на order_id первого РП, необходимо передавать order_id указанный при регистрации первого РП. Длина 6-20 символов. |
...
| Указывается только для recurrent_type=next | 123456 (минимально 6 знаков) | ||
| background | 1.0, 2.0 | Параметр указывающий на то, что запрос выполняется в фоновом режиме | 1 |
| check | 2.0 | Подпись версии 2.0 – электронная подпись запроса. См. приложение №1 | Обязательна передача параметра version=’2.0’ и service_id. Параметр key в данном случае не требуется. |
| service_id | 2.0 | Идентификатор сервиса, обязательно для версии 2.0. | 121233 |
| version | 2.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 | Назначение | Примеры/примечания |
| operation | 1.0, 2.0 | Действие над рекуррентом, должно быть “cancel” | |
| order_id | 1.0, 2.0 | order_id переданный при регистрации РП | |
| service_id | 1.0, 2.0 | Идентификатор сервиса |
...
| check |
...
| 2.0 |
...
| Подпись версии 2.0 |
...
| – |
...
| электронная подпись запроса. |
...
| См. приложение №1 | |||
| version | 2.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.
| Table of Contents |
|---|