Бонусы iiko Card
Раздел WooCommerce → iiko → Bonuses / Loyalty — встроенная бонусная система iiko.
Альтернатива
Внешняя лояльность — Loona.ai. Используется вместо или вместе с iiko Card.
Включение
| Настройка | Ключ | По умолчанию | Назначение |
|---|---|---|---|
| Включить лояльность | iiko_enable_loyalty_system | no | Включить бонусы iiko. |
| Программа лояльности | iiko_bonuses_program_id | — | Выбор программы (select из iiko). |
| Лимит % оплаты | iiko_bonuses_limit | 30 | Максимальный % заказа (5–100). |
| Удержание бонусов | iiko_hold_bonuses | no | Hold при оформлении (вместо списания). |
| Текст-подсказка | iiko_bonuses_hint | Оплачивайте бонусами до {limit}% заказа! | Подсказка на checkout. |
| ID программы | iiko_bonuses_program_id | — | UUID программы. |
По умолчанию выключено
В режимах доставки, QR и pay-by-table бонусы выключены по умолчанию. Включите явно, если нужна лояльность.
Лимиты по режимам
Лимит % оплаты бонусами хранится в одной настройке iiko_bonuses_limit и применяется во всех режимах. В config/settings.php для каждого режима задан дефолт:
| Режим | Дефолт iiko_bonuses_limit | Что значит |
|---|---|---|
| Доставка | 30 | Бонусы работают «из коробки». |
| QR-меню | 0 | Лимит не определён, расчёт скидки не выполняется. Чтобы включить — установите любое ненулевое значение. |
| Оплата по столу | 0 | Аналогично. Бонусная скидка применяется индивидуально по категории гостя iiko. |
Это дефолты, а не «бонусы выключены». В любом режиме можно оплатить бонусами: установите iiko_bonuses_limit в WooCommerce → iiko → Bonuses / Loyalty и сохраните настройки.
Сценарий «QR-меню с бонусами»
В ресторане с QR-меню (режим стола) можно разрешить гостям оплачивать бонусами:
- WooCommerce → iiko → Bonuses / Loyalty.
iiko_bonuses_limit = 30.- Сохраните.
Гость сканирует QR → выбирает блюда → на checkout видит свой баланс iiko Card и чекбокс «Оплатить бонусами» (как в доставке).
Как работает на checkout
- Авторизованный клиент видит свой баланс.
- Чекбокс «Оплатить бонусами» + поле ввода суммы (до лимита).
- Подсказка
iiko_bonuses_hint(с плейсхолдером{limit}). - Динамический пересчёт итога (как fee).
Шорткод [user_balance] — отображение баланса на любой странице.
Hold vs списание
iiko_hold_bonuses | Поведение |
|---|---|
no | При оформлении бонусы списываются (spend). |
yes | При оформлении бонусы удерживаются (hold) — финальное списание после подтверждения. |
Возврат при отмене
При отмене заказа (cancelled) бонусы возвращаются клиенту автоматически.
Лимиты и валидация
- Сумма бонусов не может превышать
% от итога(поiiko_bonuses_limit). - Минимум 5%, максимум 100%.
- Баланс берётся из iiko API (программа лояльности).