Реализация офлайн-интеграции

Общие принципы Cardsmobile Gift Cards Offline Service

Информационное взаимодействие организуется путем обмена файлами через файлообменный сервис, развертываемый в защищенной среде платформы Cardsmobile. Для передачи и приема файлов партнер использует протокол передачи файлов sFTP:

Информационное взаимодействие с партнером

Авторизация доступа к файлам

Для подключения используются логин и пароль, сформированные для партнера Cardsmobile. Партнеру передаются следующие параметры подключения:

Параметры

Описание

host:port

Адрес хоста Cardsmobile, на котором расположен сервер sFTP

login:password

Имя пользователя и пароль для авторизации сервером sFTP

Передаваемые данные

Cardsmobile и партнер обмениваются следующими реестрами (каждый реестр передается в отдельном файле):

  • Реестр предактивированных сертификатов (включает в себя данные о сертификатах, которые партнер зарезервировал для выпуска клиентам в приложении «Кошелёк»). Этот реестр регулярно передается партнером Cardsmobile;

  • Реестр обновлений сертификатов. Реестр содержит данные сертификатов, состояние которых было изменено партнером. Этот реестр регулярно передается партнером Cardsmobile;

  • Реестр сертификатов, выпущенных Cardsmobile. Реестр включает в себя данные о сертификатах, которые были выпущены платформой Cardsmobile для партнера в приложении «Кошелёк». Этот реестр регулярно передается Cardsmobile партнеру.

Кроме обмена реестрами партнер должен предоставить Cardsmobile формат используемого штрих-кода сертификатов (передается один раз, при подготовке к интеграции).

Требования к файлам

Все данные передаются в файлах формата CSV, сжатых с использованием алгоритма сжатия zip. Содержимое файлов записывается с использованием кодировки UTF-8, первая строка файла трактуется как заголовок и игнорируется при разборе файла. В качестве разделителя значений используется символ ';'.