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

WordPress и WooCommerce

Плагин, виджет и webhook заказов WooCommerce для бонусной программы МСБонус

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

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

Интеграция подходит интернет-магазинам на WordPress и WooCommerce. Покупатель может проверить баланс, списать бонусы, применить промокод или сертификат, а после выполнения заказа получает начисление по правилам МСБонус.

Плагин

Архив msbonus-woocommerce.zip скачивается из настроек интеграции. Используйте версию 1.1.4 или новее.

JS-виджет

Подключается плагином автоматически. Запросы проходят через WordPress, секретный API-ключ остаётся на сервере.

Webhook

Передаёт изменения статуса заказа для начисления бонусов и обработки возвратов.

1

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

Настройки / Интеграции / WordPress

  • ✓Включите интеграцию и скопируйте API-токен для плагина и секрет webhook. Оба значения используются только на сервере WordPress.
  • ✓Скачайте архив плагина WooCommerce.
  • ✓Настройте внешний вид виджета и каналы кодов подтверждения.
2

Установите плагин

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

  1. 1Откройте WordPress / Плагины / Добавить новый / Загрузить плагин.
  2. 2Выберите архив msbonus-woocommerce.zip из настроек МСБонус и активируйте плагин.
  3. 3В WooCommerce / Настройки / MSBonus вставьте API-токен и секрет webhook, включите виджет, сохраните настройки и нажмите Проверить подключение.

Обновление старого подключения

В версиях плагина до 1.1.4 и старом коде ручной установки API-ключ попадал на страницу оформления заказа. Обновите плагин, удалите ранее добавленный вручную код виджета и очистите кеш сайта, оптимизатора JavaScript и CDN. Затем в МСБонус / Настройки / API нажмите Сгенерировать новый ключ. Заново откройте Настройки / Интеграции / WordPress, скопируйте обновлённый API-токен для плагина и сохраните его в WooCommerce / Настройки / MSBonus. Это общий ключ магазина, обновите его также в остальных интеграциях, использующих прежний ключ. Если раздел API недоступен, обратитесь в поддержку. Не публикуйте ключ в HTML или JavaScript.
3

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

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

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

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

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

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

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

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

В плагине 1.2.1 откройте WooCommerce / Настройки / MSBonus / Сопоставление товаров. Нажмите Найти совпадения, проверьте пары с одинаковыми названиями и нажмите Сопоставить совпавшие. Сохранённые связи не изменятся. Для остальных товаров нажмите Выбрать товар и найдите карточку МойСклад по названию или артикулу. После привязки названия могут различаться.

Список товаров сайта можно отфильтровать по названию, артикулу, категории и статусу сопоставления. При поиске карточки МойСклад доступен фильтр по группам. Категории и группы включают вложенные разделы. Массовые действия применяются ко всему отфильтрованному списку, включая другие страницы. Вариации показываются отдельно.

Для промокодов с ограничениями по товарам и группам данные МойСклад проверяются автоматически и сохраняются на 60 секунд. Без привязки используется единственное точное совпадение названия. Сначала обновите сервер МСБонус, затем плагин. После изменения сопоставления повторно примените промокод в корзине.

Чтобы оставить только промокоды и сертификаты, в WooCommerce / Настройки / MSBonus отключите Показывать блок «Бонусная программа». Сам виджет и отображение промокодов в панели МСБонус должны быть включены. Начисление бонусов за заказы настраивается отдельно.

Чтобы убрать отдельное поле телефона из блока промокода, в WooCommerce / Настройки / MSBonus отключите Показывать телефон в блоке промокода. Виджет возьмёт номер из данных заказа. Заполните его перед применением кода; при смене номера промокод нужно применить повторно.

Подписи скидок меняются в WooCommerce / Настройки / MSBonus, поля Название скидки по промокоду и Название списания бонусов. Используйте обычный текст без HTML.

В виджете заказа покупателя МойСклад блок Промокод с сайта показывает код МСБонус и сумму скидки при оформлении WooCommerce. Для интеграции amgroup номер заказа сайта должен передаваться в дополнительное поле Номер заказа2. Данные отображаются при совпадении покупателя и подтверждённого применения промокода. При отсутствии связи, отмене или полном возврате блок скрыт. Сумма информационная, повторно скидка не применяется. Для этой возможности обновите сервер МСБонус и виджет МойСклад.

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

Бонусы списываются при оформлении заказа и возвращаются при отмене или возврате. Начисление за покупку выполняется при статусе Выполнен. В настройках плагина должна быть включена опция Отправлять webhook. В плагине 1.2.5 дополнительные промежуточные статусы работают без настройки. Если магазин использует свои статусы завершения, отмены или полного возврата, выберите для них действие в WooCommerce / Настройки / MSBonus / Дополнительные статусы заказа. Остальные оставьте как Промежуточный этап. Стандартные статусы сопоставлять не нужно. Действие применяется при следующей передаче заказа, включая повторные попытки. Частичные возвраты учитываются по данным WooCommerce, выбирать для них полный возврат не нужно. Проверьте тестовый заказ, при ошибке передачи причина отображается в примечаниях к заказу WooCommerce.

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

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

Написать в Telegram