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

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

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

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

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

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

Параметры

Описание

host:port

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

login:password

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

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

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

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

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

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

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

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

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