Реферальная программа

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

1. Установка

1. Создайте резервную копию файлов и базы данных магазина.
2. Если используется другой реферальный модуль, выключите его, чтобы исключить двойную атрибуцию и двойные начисления.
3. Загрузите файлы в корень CS-Cart и установите модуль в разделе «Модули → Скачанные модули».
4. Откройте «Маркетинг → Реферальная программа» и проверьте сводку.

2. Выбор участников

На вкладке «Основные настройки» выберите, кто может получать персональные ссылки, видеть свой реферальный кабинет и получать баллы:

• все активные зарегистрированные пользователи типа «Покупатель»;
• все активные продавцы;
• все активные администраторы;
• пользователи из выбранных доступных групп CS-Cart.

Настройки объединяются по правилу «ИЛИ». Например, если типы пользователей не выбраны, а выбрана группа «MLM», участвуют только активные пользователи этой группы. Если не выбран ни один тип и ни одна группа, участников программы нет.

3. Рекомендации покупателям

1. Укажите срок действия рекомендации. Значение 0 полностью выключает рекомендации покупателям; значение больше 0 задаёт срок хранения перехода до регистрации или авторизации.
2. Участник формирует ссылку с параметром sr_ref. Она может вести на любую разрешённую страницу магазина.
3. После успешной регистрации или авторизации покупатель закрепляется за участником. Стандартные способы регистрации и входа CS-Cart обрабатываются автоматически.
4. При необходимости выберите группу для новых покупателей, зарегистрированных по рекомендации. После успешного закрепления новый аккаунт добавляется в эту группу; существующим покупателям при обычной авторизации группа не назначается.
5. Выбранную группу можно использовать в штатных скидках и промоакциях CS-Cart.
6. После закрепления срок cookie больше не применяется: последующие подходящие заказы учитываются без повторного перехода по ссылке.
7. Новая ссылка другого участника не меняет уже созданную связь.

4. Начисления

1. На вкладке «Начисления» выберите подтверждающий статус заказа.
2. Выберите фиксированное начисление или процент от участвующей суммы заказа и укажите размер в единственном поле прямого начисления.
3. Для процента задайте коэффициент баллов на единицу основной валюты.
4. При необходимости исключите товары, категории и тарифы продавцов через штатные окна поиска и множественного выбора CS-Cart. Вводить ID вручную не требуется.
5. Нажмите «Опубликовать текущие правила». Новые заказы получают неизменяемый снимок опубликованных правил.
6. Оформите тестовый заказ, проверьте подтверждение, повторный статус, отмену, полный и частичный возврат.
7. После успешной проверки включите начисления прямому участнику.

5. MLM и приглашения в программу

Все параметры этого сценария находятся на отдельной вкладке «MLM».

1. Укажите срок действия приглашения в программу. Значение 0 выключает новые приглашения и создание новых MLM-связей.
2. Отдельная ссылка с параметром sr_partner сохраняет пригласившего до отправки заявки на участие.
3. После одобрения заявки новый участник добавляется в дерево. Простая регистрация пользователя сама по себе MLM-связь не создаёт.
4. Настройте максимальную глубину, награды уровней 1–3 с заказов и фиксированные награды за добавление участника.
5. Проверьте запрет самоприглашения, второго родителя и циклов.
6. После приёмки включите MLM-начисления с заказов.

6. Личный кабинет участника

• Разрешённый участник открывает «Реферальную программу» из меню своего аккаунта на витрине.
• На вкладке «Обзор» доступны персональные ссылки и генератор ссылки на выбранную страницу магазина.
• Вкладки «Заказы», «Начисления», «Команда» и «Условия» показывают обезличенные данные из единого расчётного сервиса модуля.

7. Внешний кабинет и нестандартная авторизация

• Укажите разрешённый HTTPS callback и отдельный server-to-server секрет.
• Внешний кабинет обменивает одноразовый browser-code на claim-token и завершает закрепление через API после успешной авторизации пользователя.
• Если магазин использует собственный способ входа, который не вызывает стандартные хуки CS-Cart, интеграция должна вызвать post-auth hook модуля или endpoint закрепления.
• Не передавайте handoff secret в браузер и не сохраняйте открытые реферальные идентификаторы как доверенные данные.

8. Проверка перед запуском

• Проверьте доступ для каждого разрешённого типа и выбранной группы, а также отказ для остальных пользователей.
• Проверьте значения 0 и 30 для обоих сроков.
• Проверьте обычную регистрацию, обычный вход и используемый нестандартный способ авторизации.
• Проверьте назначение выбранной группы новому реферальному покупателю и отсутствие назначения существующему покупателю после входа.
• Проверьте поиск, сохранение и повторное отображение исключённых товаров, категорий и тарифов продавцов.
• Проверьте пункт меню и все вкладки личного кабинета разрешённого участника, а также отказ пользователю вне аудитории.
• Проверьте одноразовость токенов, самореферал, повторные статусы заказа, возвраты и Multi-Vendor-разделение заказа.
• Настройте регулярный запуск обработчика очереди до включения начислений на рабочем магазине.

9. Ограничения

• Приветственный бонус новому покупателю не начисляется.
• Баллы не являются денежным кошельком; вывод и выплаты не поддерживаются.
• Смена родителя и ручная перепривязка требуют отдельного административного действия с аудитом.