Skip to main content
Loyalty programs thrive when customers can easily see their rewards and understand their value. By using the Get Customer Balance API, you can create a clear and motivating view of a customer’s points balance, helping them track their earnings and see how close they are to redeeming rewards.

​
Response Example

{
    "totalPointsBalance": 1500,
    "totalPointsValue": 75.0,
    "availablePointsBalance": 1200,
    "availablePointsValue": 60.0,
    "pendingPoints": 300,
    "pendingPointsValue": 15.0,
    "currency": "USD",
    "pointsName": "Reward Points",
    "nextExpiringPointsAmount": 200,
    "nextExpiringPointsValue": 10.0,
    "nextExpiringPointsDate": "2024-12-01T00:00:00",
    "totalEarnedPoints": 2500
}

​
Display Ideas

Points Summary

  • Total Points: Highlight the total points balance and its equivalent monetary value
  • Available Points: Show points available for immediate use
  • Pending Points: Display points pending approval, along with their value

Call-to-Action

Emphasize available points and their redemption potential (e.g., “Redeem 1200 points to save $60!”)

Expiring Points Alert

Notify customers about upcoming expiring points and their expiration date

Progress Indicator

Show a progress bar or similar visual element to indicate pending or expiring points relative to the total
Customer balance UI example

Get Customer Balance API

Retrieve customer balance including available and pending points

Build Your Own UI

Back to Build Your Own UI overview