Limits
Points campaigns use the same limit system as Discount campaigns. Two evaluation modes apply:
- ✅ Real time — checked on every transaction, enforced immediately, no overshoot.
- ⏱ Background worker (~5 min) — a background job recalculates the counter every ~5 minutes. Transactions processed before the next refresh can exceed the limit slightly.
For the full reference — enforcement order, period options, examples, configuration paths, and the overshoot caution — see Limits (Discounts).
Quick reference
| Limit | Scope | Evaluation | Notes for Points campaigns |
|---|---|---|---|
| Global accumulation cap | All campaigns, per customer | ✅ Real time | Configured in Configuration → Promotions → Points & Wallet → Points → Limits. Monetary cap on total balance earned per period. |
| Chances to accrue | Campaign total (all customers) | ⏱ Soft (~5 min) | Counter updated by background worker. Campaign stops firing once reached, but may overshoot briefly. |
| Chances to accrue per customer | Per customer, per campaign | ✅ Real time | The per-customer campaign cap. Checked with a DB query on every qualifying transaction or event. |
| Campaign budget | Campaign total value | ⏱ Soft (~5 min) | Counter updated by background worker. Same overshoot risk as Chances to accrue. |
| Max amount per transaction | Single event | ✅ Real time | Maximum points or wallet amount awarded in one transaction. Applied during calculation. |
| Limit of effects | Per evaluation | ✅ Real time | Only for Cart events. Caps how many times the effect fires in a single transaction. |
Per-campaign limits (Chances to accrue, Chances to accrue per customer, Campaign budget, Max per transaction) are set in the Limits section of the campaign form. The Limit of effects is configured in the Effects section.