Начисление баллов
Когда начисляется кешбэк, по какой формуле считаются баллы, как обновляется квартальный итог и уровень клиента.
Cheffy начисляет кешбэк баллами автоматически после оплаты заказа. В этом разделе описано, в какой момент это происходит, по какой формуле считается сумма и как меняются уровень и квартальный итог клиента.
Когда начисляются баллы
Баллы начисляются после подтверждения оплаты заказа, а не в момент его оформления. Триггером служит событие захвата платежа (payment.captured). Это значит:
- если заказ оформлен, но не оплачен — баллы не начисляются;
- начисление одинаково работает и для заказов с сайта, и для заказов из кассы (POS);
- если оплата проходит позже оформления, баллы появятся именно в момент подтверждения оплаты.
Защита от двойного начисления
По каждому заказу кешбэк начисляется ровно один раз. Если событие оплаты придёт повторно, Cheffy обнаружит, что баллы за этот заказ уже начислены, и пропустит повторное начисление.
Что происходит при начислении
Обновляется квартальный итог
Сумма оплаченного заказа прибавляется к квартальному итогу клиента. Это происходит сразу и видно клиенту.
Пересчитывается уровень
По новому квартальному итогу определяется уровень: берётся самый высокий уровень, порог которого не превышает квартальную сумму. Уровень тоже обновляется сразу.
Начисляется кешбэк
По ставке текущего уровня считается количество баллов и записывается в историю. Если уровень — «Начальный» (0 %), кешбэк не начисляется.
Баллы уходят в холд
Начисленные баллы попадают в «ожидание» (pending) на срок задержки активации (по умолчанию 3 дня), после чего становятся доступны. См. Отложенные баллы и активация.
Формула расчёта
Количество начисляемых баллов считается так:
баллы = floor(сумма заказа × процент уровня / 100)Результат округляется вниз до целого. Процент берётся из настроек уровня, на котором клиент оказался после прибавления текущего заказа к квартальному итогу.
Пример
Клиент с квартальным итогом 40 000 ₽ (уровень Бронзовый, 3 %) оплачивает заказ на 8 000 ₽.
- Квартальный итог становится 48 000 ₽ → уровень повышается до Серебряного (порог 45 000 ₽, ставка 6 %).
- Кешбэк считается уже по новой ставке:
floor(8000 × 6 / 100) = 480баллов. - 480 баллов уходят в холд и активируются через 3 дня.
Уровень применяется к текущему заказу
Поскольку квартальный итог обновляется до расчёта кешбэка, заказ, который поднял клиента на новый уровень, уже получает кешбэк по новой, более высокой ставке.
Что видит клиент и администратор
Сразу после оплаты:
- уровень и сумма за квартал обновляются мгновенно и отображаются в карточке клиента и в личном кабинете;
- начисленный кешбэк показывается как баллы в холде с пометкой «в ожидании»;
- рядом отображается дата ближайшей активации.
Блок «Бонусная программа» в карточке клиента сразу после оплаты заказа: поле «Уровень» = «Серебряный», «Доступные баллы» = 0, «Баллы в холде» = 480 с оранжевым бейджем «в ожидании», «Сумма за квартал» = 48000 RUB, ниже панель «Ближайшая активация: 480 баллов» с подписью «через 3 дня».
Связанные разделы
- Настройка уровней и кешбэка — пороги и проценты, по которым считается начисление.
- Отложенные баллы и активация — что происходит с баллами в холде.
- Заказы — жизненный цикл заказа, к которому привязано начисление.
- Возвраты и реверс баллов — что происходит при отмене или возврате оплаченного заказа.