Skip to main content
Once a customer is identified, retrieve their loyalty balance so staff can show available points, their monetary value, and any points expiring soon. Surfacing the balance at checkout boosts redemption rates and reinforces the value of the program, creating a natural “use it before you lose it” prompt.

​
Retrieve the Balance

Call the Get Customer Balance API as soon as the customer is identified, passing their customerId:

​
Fields to Display

​
number
Points the customer can redeem immediately.
​
number
Monetary equivalent of the available points, in the account currency.
​
number
Points earned but not yet confirmed (and therefore not yet redeemable).
​
number
Number of points expiring next. Pair with nextExpiringPointsDate to prompt urgency.
​
string
Date the next batch of points expires.
Behind the scenes, Gameball returns the most up-to-date view of the customer’s reward profile, calculating point values along with any pending or expiring balances.
Give your cashiers a ready-made prompt, for example: “You have 1,200 reward points worth 120 SAR. Would you like to use them today? 200 points expire soon.”

​
Tips & Gotchas

  • Always retrieve the balance before enabling redemption or prompting for point usage.
  • Display both the numeric balance and its monetary equivalent (availablePointsValue).
  • Use nextExpiringPointsDate and nextExpiringPointsValue to drive customer-facing urgency.
  • Rely on real-time calls. Only add caching if you’re explicitly controlling refresh timing.

​
Next Step

Ready to reward the purchase? Continue to Track Orders & Earn Points.