Russian
Реализация офлайн-интеграции
Общие принципы 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.
Первая строка файла трактуется как заголовок и игнорируется при разборе файла.
В качестве разделителя значений используется символ ;.