Point Balances
The points summary explained: usable, locked, unmatured, the reconciliation identity, and balances per centre
One lookup (points summary) answers every balance question a customer or your staff might ask. The same numbers head the customer's profile in the app.
What the Summary Tells You
Number | In plain words |
|---|---|
Total points | The customer's overall balance |
Usable points | What they can spend right now — matured, unexpired, minus anything on hold |
On hold | Reserved by a redemption that is mid-flight (awaiting the customer's code or the till's confirmation) |
Not yet unlocked | Recently earned points still in their waiting period |
Lifetime totals | Everything ever earned, spent, expired, and reversed |
The Numbers Always Add Up
The lifetime totals are not separate counters — they are views of one history, and one equation always holds:
earned − spent − expired − reversed = balanceAudit with confidence
Why Usable Can Be Less Than Total — and the Setting Behind Each Reason
Reason | The configuration behind it |
|---|---|
A waiting period | Per rule or tenant default, any duration — see Maturity & Expiry |
A hold | Hold points for, in minutes — see Pending Redemptions & Release |
Expiry | Point lifetime per rule or tenant default — see Maturity & Expiry |
A debt | The negative-balance option under Taking points back — see Reversals |
Another centre's points | With store separation on, the summary is scoped to the centre asking — see Centres & Store Separation |
How a Balance Was Reached
Purchase points, referral rewards and uploaded points all land in the same balance and obey the same rules. A member's profile shows the reconciliation line by line — Referral milestones, Referee welcome, Purchase / earn, Redeemed, Expired — down to Available Points (redeemable now), with any held referral rewards called out separately: held points are not yet in Available and release on maturity.
Last updated on