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

OpenCart

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

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

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

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

Модуль OCMOD

Выберите архив для OpenCart 3.0.3.8 или ocStore 2.3 и установите его стандартным установщиком дополнений.

JS-виджет

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

Webhook

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

1

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Есть отдельные архивы для OpenCart 3.0.3.8 и ocStore 2.3 со стандартным checkout. Для Journal3, Simple, Quick Checkout и других кастомных тем обратитесь в поддержку перед подключением.

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

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

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

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

Написать в Telegram