Loyalty & Rewards Engine · Documentation
User Journey
The end-to-end path through Loyalty & Rewards Engine, from trigger to outcome.
← Loyalty & Rewards Engine- 1
Stay → points → reward
A stay calls `accrue`, awarding `round(spend / 100 × earnRate)` points (earn rate 1× Silver / 1.25× Gold / 1.5× Platinum) and appending an accrual to the history. Lifetime points drive the tier (>9000 Platinum, >3500 Gold, else Silver), so crossing a threshold re-tiers the account and changes the earn rate. Redeeming a reward deducts its cost (blocked if the balance is short) and appends a redemption.
- 2
Ripple through the ecosystem
Every accrual/redemption emits `loyalty.accrued` / `loyalty.redeemed` on the shared bus, and the account is read by #31 Upsell (Gold/Platinum boost higher-value offers) and #11 Segmentation. Referral rewards (#42) also accrue here, so loyalty is the one balance the whole guest-experience cluster shares.