Бонусы Loona.ai
Loona.ai — внешняя система лояльности. Альтернатива встроенным бонусам iiko Card.
iiko Card vs Loona
- iiko Card — встроенная лояльность iiko.
- Loona.ai — отдельный сервис. Можно использовать вместо или вместе.
Включение
Раздел WooCommerce → iiko → Loona Bonuses.
| Настройка | Ключ | По умолчанию | Назначение |
|---|---|---|---|
| Включить модуль | loona_bonuses | no | Главный переключатель. |
| API-ключ | loona_key | — | Ключ Loona.ai API. |
| Шаблон лояльности | loona_template | — | ID шаблона лояльности. |
| День рождения по умолчанию | default_user_birthday | 1970-01-01 | Если не указан клиентом. |
| Лимит % оплаты | loona_percent_limit | 50 | Максимальный % заказа. |
| Подсказка | bonuses_hint | — | Текст в чекауте. |
Как работает
- Клиент регистрируется на сайте → автоматически создаётся пользователь Loona (
POST /version1/passes). - На checkout — чекбокс «Использовать бонусы» с балансом.
- Клиент вводит сумму (до
loona_percent_limit%). - При успешном экспорте заказа — бонусы списываются (
POST /version1/transactions/purchase-spending). - При отмене/возврате заказа — бонусы возвращаются.
Шорткод баланса
text
[loona_balance phone="+79991234567"]Показывает баланс бонусов Loona для указанного телефона.
На checkout
- Чекбокс «Использовать бонусы» (
woocommerce_review_order_before_order_total). - Отображение баланса.
- Подсказка
bonuses_hint. - Динамический пересчёт итога.
Тестирование API
В админке, после кнопки сохранения — виджет тестирования API:
- 4 AJAX-эндпоинта: getUser, getUserBalance, createUser, addOrderToUser.
- Проверка подключения к Loona.ai перед боевой работой.
Что использует Loona
- Loona.ai API (OAuth2, REST):
GET /version1/passes— поиск пользователя.GET /version1/passes/{id}— данные.POST /version1/passes— создание.POST /version1/transactions/purchase-spending— списание.
- Order meta
use_bonuses. - Session key
use_iiko_bonuses.