Raiffeisenbank cards API (0.1)

1. Отправляйте список сотрудников через интернет-банк в формате XLS, CSV или XML. Список сотрудников можете заполнять вручную или выгружать из вашей учетной системы.
2. Если заказываете карты в отделение банка, срок доставки через 3-5 дней. Если заказываете карты на адреса держателей (только для форматов XLS и CSV), срок доставки через 5-7 дней в зависимости от региона доставки. Держатели получат СМС о готовности карты.

Шаблон реестра: XLS

Примеры реестров: XML_1 XML_2 CSV

Инструкция по выгрузке реестра из 1С

Список отделений для получения карт

После заключения договора вам придет письмо о подключении к сервису с авторизационными данными.

1. Интегрируйте наш API с вашей учетной системой.
2. Отправляйте список сотрудников.
3. Проверяйте статус готовности карт.
4. Через 3-5 дней карты доставят в отделение банка. Держатели получат СМС о готовности карты.

Взаимодействие осуществляется по протоколу HTTP с использованием методов GET/POST (в описании каждого запроса явно указан требуемый метод и адрес). POST-запросы используют JSON-аргументы, GET-запросы работают со строками запросов.

API всегда возвращает ответ в формате JSON, независимо от типа запроса. Ответ любого метода содержит код сообщения (code). Если в процессе обработки любого запроса произойдет логическая ошибка, API вернет дополнительно описание ошибки (message).

Для авторизация запросов необходимы:

• secretKey - секретный ключ, который используется для межсервисного взаимодействия.

ВАЖНО: Секретный ключ необходимо хранить в защищенном месте, нельзя публиковать на сторонних ресурсах или передавать третьим лицам.

Межсервисные запросы авторизуются посредством секретного ключа API (SECRET_KEY). Параметр авторизации указывается в заголовке Authorization, значение которого формируется как "Bearer SECRET_KEY". API

Для реализации взаимодействия Райффайзенбанк предоставляет API:

• запрос на создание карт с использованием HTTP;
• получение информации о статусе запроса на создание карт

Для получения информации о доставке карты Райффайзенбанк предоставляет API:

• Информация о доставке карты

Для просмотра информации и управления картой Райффайзенбанк предоставляет API:

• Просмотр списка карт
• Подробная информация по карте
• История действий
• Список операций
• Реквизиты карты
• Установка лимитов
• Блокировка, разблокировка и закрытие карты

API для просмотра информации и управления счетами:

• Получение баланса счёта, к которому привязаны карты

Дополнительная информация для выпуска карт

Для информирования Компании о проведенных операциях по картам могут использоваться уведомления на адрес, указанный в настройках. В составе API имеется следующий функционал:

• уведомление о блокировке средств на карте (статус HOLD);
• уведомление о списании средств по счету (статус CAPTURE);
• запрос на отправку уведомления в тестовом контуре с использованием HTTP;

Взаимодействия осуществляются через протокол HTTP посредством метода POST как для исходящих из банка сообщений, так и для входящих.

Адреса для тестовой и продакшн сред можно указать с помощью метода в API.

Для партнёра уведомление представляет собой входящий POST-запрос, который использует JSON-структуру.

Уведомление считается принятым, если получатель ответил на запрос HTTP-кодом 200.

Ответы с любыми другими HTTP-кодами будут считаться невалидными. Повторные попытки отправки будут проводиться в течение суток с нарастающим интервалом.

Для проверки подлинности уведомления к данным добавляется подпись в заголовке x-api-signature-sha256, полученная на основе общего секретного ключа и контрольной строки (operation.authorization.amount|operation.card.id|operation.created|operation.id|operation.status.value) с помощью HMAC-SHA-256.

Помимо этого предоставляется опциональная возможность дополнительной аутентификации (authType) посредством логина и пароля (authType = BASIC), либо через bearer-токен (authType = BEARER).