Вернуться к документации

OpenCart

OCMOD-модуль, виджет и webhook заказов OpenCart 3.0.3.8 для бонусной программы МСБонус

Как работает связка

OpenCart передаёт заказ, МСБонус применяет правила лояльности

Интеграция проверена на OpenCart 3.0.3.8 с дефолтной темой. Для другой версии OpenCart, Journal3, RuPack и других нестандартных тем напишите в поддержку перед подключением: может понадобиться адаптация. Покупатель проверяет баланс, списывает бонусы, применяет промокод или сертификат, а после выполнения заказа получает начисление по правилам МСБонус.

Модуль OCMOD

Архив msbonus-opencart.ocmod.zip ставится через стандартный установщик расширений OpenCart.

JS-виджет

Встраивается в страницу оформления заказа: баланс, поле списания, промокод и сертификат.

Webhook

При переходе заказа в выбранный статус (например, «Завершён») запускается начисление бонусов.

1

Включите OpenCart в МСБонус

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

  • ✓Включите интеграцию, скопируйте API-ключ и секрет webhook.
  • ✓Скачайте архив модуля OCMOD.
  • ✓Настройте внешний вид виджета и каналы кодов подтверждения.
2

Установите OCMOD-модуль

Загрузите архив в админке OpenCart

  1. 1В админке OpenCart откройте «Модули → Установка расширений» и загрузите msbonus-opencart.ocmod.zip.
  2. 2Перейдите в «Модули → Модификаторы» и нажмите «Обновить» (синяя кнопка справа сверху).
  3. 3Откройте «Расширения → Итоги заказа → MSBonus» и нажмите «Установить».
  4. 4Включите модуль, вставьте API-ключ и секрет webhook из настроек МСБонус, затем выберите статус заказа, при котором начисляются бонусы.
3

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

Решите, что покупатель может делать на checkout

Проверка баланса

Покупатель вводит телефон, видит баланс и доступную сумму списания.

Списание бонусов

При включённом подтверждении клиент получает код выбранным способом.

Промокоды и сертификаты

Код проверяется в МСБонус и применяется к заказу по правилам программы.

Строки в итогах чека

Списание бонусов и промокод отображаются отдельными строками в корзине OpenCart.

Совместимость тем

Виджет проверен на OpenCart 3.0.3.8 с дефолтной темой. Для другой версии OpenCart, Journal3, RuPack и других кастомных тем обратитесь в поддержку перед подключением.

Статус заказа

Начисление выполняется при переходе заказа в указанный в настройках модуля статус. Для боевого сценария обычно используется «Завершён» (status_id = 5).

Нужна помощь?

Если у вас возникли вопросы по этой теме, свяжитесь с нашей поддержкой

Написать в Telegram