Реализация офлайн-интеграции
Общие принципы Loyalty Offline Service
Информационное взаимодействие организуется путем обмена файлами через файлообменный сервис, развертываемый в защищенной среде платформы Кошелька. Для передачи и приема файлов партнёр использует протокол передачи файлов SFTP:
Авторизация доступа к файлам
Для подключения используются логин и пароль, сформированные для партнёра Кошелька. Партнёру передаются следующие параметры подключения:
| Параметры | Описание |
|---|---|
| host:port | Адрес узла платформы Кошелька, на котором расположен сервер SFTP. |
| login:password | Имя пользователя и пароль для авторизации сервером SFTP. |
Передаваемые данные
Кошелёк и партнёр обмениваются следующими реестрами (каждый реестр передаётся в отдельном файле):
- Реестр выпущенных карт лояльности. Включает в себя данные о картах, выданных партнёром клиентам в сети своих точек обслуживания, и данные карт, выпущенных для партнёра в приложении «Кошелёк». Этот реестр регулярно передается партнёром Кошелька.
- Реестр свободных номеров карт лояльности. Реестр содержит номера тех карт, которые партнёр зарезервировал для выпуска клиентам в приложении «Кошелёк». Этот реестр передается партнёром Кошелька по мере необходимости.
- Реестр карт лояльности, выпущенных Кошельком. Реестр включает в себя данные о картах, которые были выпущены платформой Кошелька для партнёра в приложении «Кошелёк». Этот реестр регулярно передается Кошельком партнёру.
Info
Кроме обмена реестрами, партнёр должен предоставить Кошельку формат используемого штрихкода карт (передается один раз при подготовке к интеграции).
Требования к файлам
Все данные передаются в файлах формата CSV, сжатых с использованием алгоритма сжатия ZIP.
Содержимое файлов записывается с использованием кодировки UTF-8.
Первая строка файла трактуется как заголовок и игнорируется при разборе файла.
В качестве разделителя значений используется символ ;.