Интеграция системы лояльности МаксБонус для бренда IF I DO

Задача

Магазин модной одежды IF I DO уже использовал программу лояльности МаксБонус в офлайн-точках продаж. Клиенты копили бонусы за покупки в магазинах, получали подарки ко дню рождения и пользовались системой уровней.

Нужно было объединить онлайн и офлайн в единую систему. Чтобы клиент мог копить бонусы и на сайте, и в магазине, видеть общий баланс и тратить их в любом канале продаж.

Что реализовали

Автоматическое начисление бонусов

После оплаты заказа на сайте система автоматически начисляет бонусы в МаксБонус. Процент начисления зависит от уровня клиента в программе лояльности:

До 50 000 ₽ покупок — 2% от суммы чека
От 50 000 до 100 000 ₽ — 4% от суммы
От 100 000 ₽ и выше — 5% от суммы

Бонусы активируются через 7 дней после покупки и хранятся 1 год. Это стандартные правила МаксБонус, которые уже работали в офлайн-магазинах.

Регистрация в программе лояльности

Когда клиент создаёт аккаунт на сайте или авторизуется впервые, система проверяет его номер телефона в МаксБонус. Если клиент уже есть в базе (покупал офлайн) подтягиваются его данные и баланс. Если нет, создаётся новая карточка участника программы и начисляются приветственные 500 бонусов.

Списание бонусов при оплате

В корзине клиент видит блок с информацией о бонусах. Можно указать, сколько бонусов использовать для оплаты. Система запрашивает у МаксБонус доступный лимит списания и пересчитывает итоговую сумму заказа.

Процент списания настраивается в панели МаксБонус. Обычно это 30-50% от суммы заказа, чтобы клиенты не оплачивали покупки полностью бонусами.

Личный кабинет клиента

В личном кабинете на сайте отображается:

Текущий баланс бонусов
Уровень в программе лояльности
История последних операций (начисления и списания)
Информация о приветственных и праздничных бонусах

Данные обновляются при каждой авторизации клиента и после оформления заказа. Это работает через API МаксБонус — система запрашивает актуальный баланс и историю операций в реальном времени.

Виджет в карточке заказа

Менеджеры магазина могут управлять бонусами через специальный виджет в карточке заказа. Это полезно, когда заказ оформляется по телефону или нужно скорректировать начисления вручную.

В виджете видно:

Статус операции в МаксБонус (успешно/ошибка)
Номер чека для быстрого поиска в системе
Возможность списать бонусы за клиента
Кнопка для ручного начисления бонусов

Это важно для частичных возвратов, которые часто случаются в нише модной одежды. Менеджер может скорректировать начисление под конкретную ситуацию.

Специальные начисления

Программа лояльности включает несколько типов автоматических начислений:

Регистрация: 500 бонусов при создании аккаунта, действуют 30 дней
День рождения: 1000 бонусов за неделю до даты, действуют 14 дней
За покупки: 2-5% от суммы в зависимости от уровня, активируются через 7 дней

Все эти правила настроены в МаксБонус и работают автоматически. Клиенты получают уведомления в Telegram-боте о начислениях и могут перейти на сайт, чтобы потратить бонусы.

Настройки интеграции

В админ-панели InSales доступны настройки интеграции:

Подключение к API МаксБонус (токен доступа)
Выбор статуса заказа для начисления бонусов (обычно "Оплачен")
Настройка отмены операций при возврате заказа

Технические особенности

Архитектура решения

Интеграция работает через внешний скрипт, размещённый на хостинге Masterhost. Скрипт обменивается данными между InSales и МаксБонус через их API. InSales это SaaS платформа без возможности запуска серверного кода, поэтому требуется внешний хостинг.

Настройка поддомена и SSL

Один из тормозящих факторов настройка поддомена для скрипта интеграции. Домен магазина управлялся через InSales, а DNS-зоной владел регистратор Active.domains. Нужно было делегировать поддомен на хостинг Masterhost для выпуска SSL-сертификата.

Процесс потребовал согласования с тремя техподдержками: Active.domains для добавления NS-записей, InSales для подтверждения изменений DNS и Masterhost для выпуска сертификата Let's Encrypt. Это заняло около двух недель из-за праздничного периода и задержек в ответах.

Синхронизация базы клиентов

В МаксБонус уже была база клиентов из офлайн-магазинов. При первой авторизации на сайте система сверяет номер телефона с базой МаксБонус и подтягивает существующий баланс. Это позволило объединить онлайн и офлайн покупки в едином профиле клиента.

Проблемы и решения

Баг с обнулением баллов

После запуска интеграции обнаружили баг: при оформлении заказа списанные бонусы обнулялись через несколько секунд. Клиенту приходилось перезагружать страницу и заново проходить путь со списанием баллов.

Проблема была в конфликте запросов к API МаксБонус. Исправили логику обработки ответов и добавили правильную последовательность обновления данных корзины. После фикса всё заработало стабильно.

Отсутствие документации

API МаксБонус имеет не полную документацию, некоторые методы работают не так, как описано. Нужно связываться с технической поддержкой МаксБонус для уточнения деталей работы с товарами в корзине и идентификаторами продуктов.

Результат

Программа лояльности теперь работает как для онлайн, так и для офлайн покупок. Клиент видит единый баланс бонусов независимо от канала продаж. Это упростило учёт и повысило лояльность постоянных покупателей.

Менеджеры получили удобный инструмент для управления бонусами прямо из карточки заказа. Не нужно переключаться между системами всё в одном интерфейсе.

Интеграция закрыла главную проблему - разрыв между онлайн и офлайн опытом покупателей.

Нужна интеграция программы лояльности?

Работаем с Teyca, МаксБонус, Maxma, Бонус+ и кастомными решениями. Объединим онлайн и офлайн в единую систему начисления бонусов. Напишите нам для консультации.