Build Your Own Customer Balance UI

Display customer points balance, pending points, and expiring rewards using the Get Customer Balance API

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

Use nextExpiringPointsAmount, nextExpiringPointsValue, and nextExpiringPointsDate to warn customers about upcoming expiry and motivate them to redeem before losing points.

Progress Indicator

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

The Get Customer Balance API does not include a field for total points redeemed. To view a customer’s redemption history, use the Customer Activity Log in the dashboard or export redemption data from Analytics (which includes a redeemed_points column).

---

Related Resources

Get Customer Balance API

Retrieve customer balance including available and pending points

Build Your Own UI

Back to Build Your Own UI overview