Premium Bonus — платформа для автоматизированной работы с данными гостей. После подключения гости тратят накопленные бонусы при заказе через Смартомато, а баланс и списания видны в карточках клиентов и заказах Смартомато, без захода во вторую систему.
Что нужно до подключения
- Токен (API-ключ) Premium Bonus.
- Если брендов несколько (логистический центр), нужен свой API-ключ на каждую организацию. Зачем: у Premium Bonus есть квоты на каждый токен.
- Если бонусы на кассе списываются отдельным типом оплаты, этот тип оплаты заранее настроен в POS-системе.
Шаги на стороне Premium Bonus
- Клиент запрашивает токен для интеграции и передаёт его в Смартомато.
- Для логистического центра клиент просит Premium Bonus сгенерировать отдельный API-ключ на каждую организацию.
- Если в Premium Bonus нужно видеть источник заказа, список источников Смартомато передают клиенту, а он отправляет его в поддержку Premium Bonus. Обязательно, если передачу источника включают: поддержка Premium Bonus должна завести эти источники у себя.
Источники заказа Смартомато (по статье)
«Витрина», «Витрина (мобильная версия)», «Внешний сайт», «Внешний сайт (мобильная версия)», «Деливери Клаб», «Сбермаркет», «ZakaZaka», «Obed.ru», «Яндекс.Еда», «Glovo», «Board», «Мобильное приложение», «Мобильное приложение (ios)», «Мобильное приложение (android)», «Интеграция с iiko», «Tazz», «Wolt».
Документация Premium Bonus
- Документация API.
- Коллекция Postman «PremiumBonus.postman_collection.json» приложена к исходной статье.
Что передать в Смартомато
- Токен Premium Bonus, а для логистического центра — ключ для каждой организации.
- Нужна ли передача источника заказа и заведены ли источники в Premium Bonus.
- Проводит ли касса сама бонусные операции через тип оплаты. Тогда Смартомато только синхронизирует баланс, чтобы не было двойного списания.
Куда обращаться
- Поддержка Premium Bonus, через клиента: заведение источников заказа, отдельные ключи для организаций. Контактов поддержки в статье нет.
Типовые ошибки и вопросы клиентов
- Когда гость появляется в Premium Bonus? Сразу после регистрации или авторизации в Смартомато, если его ещё нет в базе Premium Bonus. Делать заказ не нужно.
- Подтягиваются ли теги клиентов из Premium Bonus? Да, при включённых бонусных категориях на нашей стороне, см. Уровни лояльности.
- Как часто синхронизируется баланс, где видна история операций и баланс в приложении — это наша сторона, см. Внешние системы лояльности.