Внешняя система лояльности. Гостей, которые уже есть в Loona, Смартомато находит по номеру телефона и типу программы лояльности. Бонусы списываются при создании заказа, а начисляются в Loona при его завершении.
Что нужно до подключения
- Макет программы лояльности в Loona. Тип лояльности в нём — «Бонус». Если тип другой, его значение узнают через API, см. ниже.
- Список полей, которые программа Loona требует от гостя (например, дата рождения, пол, фамилия).
- Если бонусы на кассе списываются отдельным типом оплаты, этот тип оплаты заранее настроен в POS-системе.
Шаги в кабинете Loona
- В разделе интеграций выбрать в каталоге интеграцию по API.
- При создании скопировать секретный ключ. Он показывается при настройке, и его всегда можно сбросить кнопкой редактирования.
- После настройки в разделе «Установленные» появится строка интеграции: скопировать из неё «Идентификационный номер».
- Открыть макет программы лояльности и посмотреть внизу тип лояльности. Зачем: гости в Loona ищутся по телефону и этому типу.
- Проверить, какие поля гостя в программе лояльности отмечены обязательными. Зачем: без них Loona не даст отправить заказ, поэтому те же поля должны быть обязательными и у нас.
Если тип лояльности не «Бонус»
- Взять идентификационный номер и секретный ключ, соединить их через двоеточие (
<номер>:<ключ>) и закодировать в base64. - Запросить токен с авторизацией
Basic <base64>. Коллекция Postman «Лояльности.postman_collection.json» с этим запросом приложена к исходной статье, тело запроса в ней не меняют. - С полученным токеном (авторизация Bearer) отправить
GET https://api.loona.ai/version1/templates. В ответе будет нужный тип лояльности.
Что передать в Смартомато
- Идентификационный номер интеграции (client_id).
- Секретный ключ.
- Тип лояльности: «Бонус» или значение, полученное через API.
- Список обязательных полей программы лояльности Loona.
- Проводит ли касса сама бонусные операции через тип оплаты.
Типовые ошибки и вопросы клиентов
- Loona не принимает заказ. Проверить обязательные поля программы лояльности: без даты рождения, пола или фамилии, если они там обязательны, Loona заказ не примет. У нас эти поля делают обязательными, см. Профиль гостя и состав полей.