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