Отложенные баллы и активация
Что такое баллы в холде (pending), чем они отличаются от доступных, когда активируются и по какому расписанию работает перенос.
Начисленный кешбэк не сразу становится доступным для траты — сначала он попадает в холд на несколько дней. Это защищает магазин: если клиент отменит заказ или оформит возврат, ещё не активированные баллы можно отозвать без риска, что клиент успел их потратить. В этом разделе описано, как устроен холд и когда баллы активируются.
Доступные баллы и баллы в холде
У каждого клиента баланс делится на две части.
- Доступные баллы — баллы, которые клиент уже может потратить на сайте или в кассе.
- Баллы в холде (pending) — начисленный кешбэк, ожидающий активации. Клиент видит их с пометкой «в ожидании», но потратить ещё не может.
Блок «Бонусная программа» в карточке клиента: рядом стоят поле «Доступные баллы» со значением и поле «Баллы в холде» со значением и оранжевым бейджем «в ожидании», ниже — информационная панель с иконкой часов и текстом «Ближайшая активация: N баллов» и подписью на русском вроде «через 2 дня 3 часа».
Срок задержки
По умолчанию баллы находятся в холде 3 дня. Срок задаётся параметром points_activation_delay_days (см. Настройка уровней и кешбэка).
- При начислении к каждой записи кешбэка проставляется дата активации = момент начисления + срок задержки.
- Если срок задержки установить в 0, баллы становятся доступными сразу, минуя холд.
Уровень и квартальный итог не ждут
Задержка касается только возможности потратить баллы. Квартальный итог и уровень клиента обновляются сразу при оплате заказа — независимо от холда.
Дата ближайшей активации
Cheffy показывает, когда активируется ближайшая порция баллов: берётся самая ранняя запись холда с будущей датой активации. В интерфейсе это отображается:
- готовой подписью на русском с правильными падежами — например, «через 2 дня 3 часа» или «через 5 часов 12 минут»;
- точной датой и временем активации.
Если до активации уже не осталось времени, показывается «уже доступны» — баллы будут перенесены при ближайшем запуске фоновой задачи.
Расписание активации
Перенос баллов из холда в доступные выполняет фоновая задача, которая запускается каждый час (в начале часа). На каждом запуске она находит все записи холда, у которых наступил срок активации, и:
- прибавляет сумму к доступным баллам клиента;
- уменьшает баллы в холде на ту же сумму;
- помечает записи как активированные, чтобы не обработать их повторно.
Активация происходит порциями по часам
Поскольку задача запускается раз в час, баллы становятся доступны не ровно в момент истечения срока, а на ближайшем часовом запуске после него. Например, если срок активации наступил в 14:20, баллы будут перенесены в 15:00.
Принудительная активация и аннулирование
Администратор может не дожидаться расписания и управлять холдом вручную прямо в карточке клиента:
- Активировать сейчас — мгновенно переносит все баллы клиента из холда в доступные.
- Аннулировать — обнуляет баллы в холде, не затрагивая доступный баланс (например, если кешбэк начислен ошибочно).
Эти действия описаны в разделе Управление баллами клиента.
Панель ближайшей активации в карточке клиента крупным планом: иконка часов, текст «Ближайшая активация: 480 баллов», подпись с относительным и точным временем, справа две кнопки — «Активировать сейчас» (вторичная) и «Аннулировать» (красная).
Связанные разделы
- Начисление баллов — откуда берутся баллы в холде.
- Управление баллами клиента — ручная активация и аннулирование холда.
- Возвраты и реверс баллов — почему холд важен при возвратах.