Бонуси й кешбек для 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 для тріалу або ключ після покупки.