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

OpenCart

OCMOD-модули OpenCart и ocStore: клиенты, каталог, заказы и виджеты ДАБонус

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

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

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

Модуль OCMOD

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

Виджеты магазина

В checkout доступны списание и промокоды, а в личном кабинете — текущий и ожидающий баланс.

Обмен данными

Передаёт покупателей и каталог, а по финальному статусу — продажу с товарными позициями.

Выберите сценарий работы сайта

Интеграции → OpenCart

  • Сайт — основная система продаж. ДАБонус начисляет бонусы по заказам сайта и обрабатывает возвраты. Исключите повторное начисление, если эти же продажи передаются в другую подключённую систему.
  • Сайт работает вместе с учётной системой. Покупатель использует общий баланс на сайте, а начисление выполняется в основной системе, например в МойСклад. Заказы сайта повторно бонусы не начисляют.

Личный кабинет покупателя

Клиенты и регистрация

Во вкладке «Карточка в кабинете» настройте заголовок, приветственный текст, цвета акцента, фона, текста и блоков, а также скругление углов. Выберите, показывать ли ожидающие бонусы, уровень лояльности и историю операций. Предпросмотр показывает пример данных клиента; баланс доступных бонусов остаётся всегда. Изменения применяются при открытии или обновлении кабинета. Оформление виджета корзины настраивается отдельно.

Во вкладке «Инструкция» настроек интеграции описаны установка, привязка существующей карты и проверка первой покупки. API-токен находится в «Установка и подключение»; используйте токен именно этого подключения. Секрет webhook переносится только в серверные настройки магазина.

Обновите плагин магазина. Во вкладке «Регистрация и коды» разрешите регистрацию новых участников. Покупатель входит в аккаунт магазина и создаёт карту по имени и телефону, приняв условия участия. В WordPress параметры установки находятся в отдельном пункте меню «ДАБонус». Баланс, ожидающие бонусы, уровень и история операций появятся внутри обычного аккаунта покупателя. Регистрация и вход выполняются средствами магазина.

Во вкладке «Регистрация и коды» всегда доступны регистрация в кабинете и в виджете заказа. Подтверждение существующей карты по умолчанию выключено: связанная карта открывается в аккаунте магазина, для первого подключения можно указать телефон. При включении подтверждения клиент запрашивает код из 6 цифр через настроенные уведомления. Вручную код выдаётся в «Клиенты» → карточка клиента → «Код доступа к карте» и действует 15 минут. В Tilda первое подключение создаёт пароль; существующий пароль можно сбросить только с кодом.

Регистрация через ботов и доставка кодов входа или списания доступны с модулем «Коммуникации». Без него эти настройки скрыты. Завершение подписки не отменяет ранее включённую защиту: клиент использует подтверждённый аккаунт сайта.

1

Включите OpenCart в ДАБонус

Интеграции → OpenCart

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Личный кабинет и товарные правила

Баланс отображается в кабинете покупателя, а позиции и категории заказа участвуют в правилах ДАБонус.

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

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

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

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

Подписи кнопок и форм

Оформление кабинета в стиле вашего сайта

В настройках интеграции откройте «Карточка в кабинете» → «Подписи кнопок и форм». Задайте тексты входа и регистрации, названия кнопок, подписи баланса и заголовок истории. Здесь же настраиваются цвета, скругления и видимость блоков.

Сверьте результат в предпросмотре, сохраните настройки и обновите кабинет на сайте. Изменение текста кнопки не меняет её действие. Виджет корзины оформляется отдельно.

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

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

Написать в поддержку в Telegram