Главная Интеграции Лояльность iikoCard

iikoCard

Обновлено Oct 21, 2026

iikoCard — бонусно-депозитная система iiko: работа с постоянными гостями и схемы корпоративного питания. Смартомато работает только с бонусными программами iikoCard.

Что нужно до подключения

  • iiko, к которой подключён iikoCard, и бонусная программа в iikoCard с заданными условиями начисления. Условия задаёт клиент в программе лояльности iikoCard.
  • Выбран способ, которым списанные онлайн бонусы попадут в чек iiko: скидка со свободной ценой или тип оплаты. Шаги для обоих способов описаны ниже.
  • Если в Смартомато уже копились бонусы, их выгружают отчётом по клиентам до подключения и передают дилеру или клиенту, чтобы он начислил их в iikoCard вручную. Зачем: после подключения баланс каждого гостя заменяется балансом из iikoCard, см. Внешние системы лояльности.

Шаги на стороне iiko и iikoCard

Вариант 1: бонусы передаются скидкой

  1. В backOffice iiko завести скидку с произвольной суммой и назвать её «Бонусы».
  2. Проверить, что скидка отдаётся методом API iiko api/1/discounts (справочник API, статья iiko). Зачем: Смартомато берёт скидку оттуда по её id.

Вариант 2: бонусы передаются типом оплаты

  1. В бонусной программе iikoCard включить чекбокс «Разрешать холдирование» (статья iiko о холдировании).
  2. Создать тип оплаты «Бонусы».
  3. В дополнительных настройках этого типа оплаты обязательно включить «Бонусная программа: Программа с холдированием (холдирование)». Зачем: без холдирования бонусы списываются дважды, см. «Типовые ошибки».

Название программы лояльности

Название бонусной программы запрашивают у клиента. Его, а заодно условия начисления и списания, можно посмотреть запросом к API iiko, см. ниже.

Проверка через API iiko (Postman)

  1. Токен: POST https://api-ru.iiko.services/api/1/access_token, в теле {"apiLogin": "<апи-логин>"}.
  2. Дальше запросы идут с авторизацией Bearer Token.
  3. Баланс конкретного гостя: POST https://api-ru.iiko.services/api/1/loyalty/iiko/customer/info, в теле phone (телефон гостя), "type": "phone" (не менять) и organizationId (id организации iiko, где настроен iikoCard). В ответе нужен walletBalances → balance.
  4. Программы лояльности организации: POST https://api-ru.iiko.services/api/1/loyalty/iiko/program, в теле organizationId. В ответе массив Programs с активными программами, их названиями и условиями.

Что передать в Смартомато

  • API-логин iiko, к которой подключён iikoCard. Он может отличаться от логина, который используется в интеграции с iiko.
  • Id организации iiko, в которой настроен iikoCard. Если брендов несколько (логистический центр), для всех передаётся один и тот же id — той организации, где подключён iikoCard.
  • Название программы лояльности в iikoCard.
  • Id скидки «Бонусы» (вариант 1) или id типа оплаты «Бонусы» (вариант 2).
  • Клиент зарубежный или нет: для зарубежных клиентов используется отдельный адрес API iiko, https://api-eu.iiko.services/api/1/.
  • Проводит ли касса сама бонусные операции через тип оплаты. От этого зависит, будет ли Смартомато отправлять в iikoCard начисления и списания или только синхронизировать баланс.

Типовые ошибки и вопросы клиентов

  • Бонусы списываются дважды: сначала холдируются, потом списываются ещё раз при закрытии заказа в iiko. Дилер включает в программе лояльности iikoCard «Разрешить холдирование», а в типе оплаты для бонусов, в дополнительных настройках, — пункт о холдировании.
  • Ошибка **IikoCardPayment can't be externally processed** при импорте заказа в iiko. Исправляется в настройках интеграции на нашей стороне, см. Внешние системы лояльности.
  • Двойное списание, когда касса сама списывает бонусы по типу оплаты. На нашей стороне включается режим, в котором Смартомато только синхронизирует баланс. В этом режиме Смартомато не начисляет за заказы, за программы лояльности и вручную из карточки клиента.

Связанные статьи