Бонусы и кешбек для OpenCart — бонусная программа с оплатой бонусами

Бонусы и кешбек для OpenCart — бонусная программа для магазина на OpenCart 2.3, 3.x и 4.x. За выполненный заказ покупатель получает назад часть стоимости товаров бонусами, а в следующий раз оплачивает ими часть корзины — отдельной строкой в итогах, как купон. Бонусы живут в собственном журнале движений: баланс не «редактируется числом», каждый бонус можно проследить до заказа.

Почему ещё один модуль бонусов. Штатные «баллы лояльности» OpenCart начисляют фиксированное количество баллов за товар: без процента от суммы, без сгорания, без уровней и без кабинета с историей, а админ не видит балансов списком. Здесь кешбек считается в процентах, имеет срок действия, а списанные бонусы уменьшают базу налогообложения так же, как скидка. Один и тот же модуль работает на 2.3, 3.0 и 4.1 — без правок файлов ядра.

Как это работает — шаг за шагом

1. Покупатель регистрируется и сразу получает приветственный бонус — столько, сколько вы поставили (0 = без бонуса).
2. Кладёт товар в корзину и видит, сколько бонусов начислим за этот заказ и сколько можно списать уже сейчас. Гостю модуль показывает прогноз и ссылку на вход.
3. Списывает бонусы. Модуль проверяет три предела: баланс, процент от суммы заказа и минимальную сумму для списания. В итогах появляется отдельная строка «Оплачено бонусами (N)».
4. Оформляет заказ. Бонусы списываются, когда заказ впервые входит в рабочий статус магазина, а не в момент нажатия кнопки: незавершённые корзины баланс не трогают.
5. Заказ становится «Выполнен» — покупателю возвращается кешбек: процент от стоимости товаров без налога и доставки, за вычетом скидок и суммы, оплаченной бонусами. Повторная запись того же статуса дубля не создаёт.
6. Заказ отменён или возвращён — списанные бонусы возвращаются полностью, а кешбек изымается. Если покупатель уже потратил часть кешбека, с баланса снимается только остаток: в минус модуль его не загоняет.
7. Бонусы сгорают по сроку каждого начисления отдельно. Просроченные не попадают в баланс даже до того, как отработает крон, — крон лишь проставляет строку «Сгорание» в истории.

Что под капотом

• Журнал движений cc_loyalty_txn: баланс — это сумма строк, а не поле, которое кто-то «поправил». Каждое начисление знает свою дату сгорания и остаток, списания идут FIFO — первыми тратятся те бонусы, что сгорят раньше.
• Оплата бонусами — отдельный order total с сортировкой 4, как купон: налог считается от суммы после бонусов, а в заказе и в чеке видна нормальная строка скидки.
• Идемпотентность. Повторная запись статуса, двойной колбек, повторная отмена ничего не дублируют: каждая операция по заказу записывается один раз.
• Не хватает бонусов на момент подтверждения — заказ не «проглатывает» разницу: он получает антифрод-статус магазина, а если он не задан — первый из статусов, при которых кешбек забирается.
• Удаление модуля не стирает журнал: бонусы покупателей — это обязательство магазина, поэтому таблица остаётся на месте.
• Токен SMS-шлюза не печатается обратно в форму: страница показывает только, что он сохранён.
• Языки: украинский и английский — админка и витрина.

Как установить

1. OpenCart 4: Расширения → Установка расширений → загрузите cc_loyalty.ocmod.zip и нажмите «Установить». OpenCart 3: Модули → Установка модулей → cc_loyalty-oc3.ocmod.zip. OpenCart 2.3: штатный установщик 2.3 копирует файлы только через FTP, поэтому содержимое папки upload/ из cc_loyalty-oc2.ocmod.zip заливается в корень магазина вручную, затем «Обновить» в списке модификаций.
2. Расширения → Расширения → Модули → CatCode Бонусы и кешбек → «Установить», затем «Редактировать».
3. Включите программу, поставьте процент кешбека, бонус за регистрацию и предел оплаты бонусами — и сохраните.
4. Добавьте крон-задание по адресу из настроек (там же ключ), чтобы работали сгорание и напоминания.
5. Для Pro: «Попробовать Pro» → e-mail для триала или ключ после покупки.