Point history page

To provide customers with a view of their recent transactions and points history, you can create a "Points" page within your mobile app. This page will display the details of each transaction related to the customer's points.

Accessing Points History

The customer's points history can be retrieved using the Transaction endpoint. This endpoint provides detailed information on all transactions related to the customer’s points, including earning and redeeming activities.

How to generate it

Fetch transactions for the customer Use a business and user filter: user URI or user__emails__email

Render each transaction, see screenshot for details Use the following fields:

• title as the activity label

• classification to label EARN vs REDEEM (show + or - or x)

• points and quantity to calculate the total (points × quantity)

Certain perks will be 0 points. In this case, your application should display just the quantity, like 1x, 3x, etc

• transaction_dt for the timestamp

• transaction_status to handle voids (see below)

Link to vouchers when present If voucher is present on the transaction, link the customer to the specific voucher, if you're rendering voucher views.

Nuances to handle

Instant rewards

Some earning rules can trigger instant rewards. In those cases:

• You may see an additional transaction created as a result of an earn.

• Treat it as a separate line item in point history.

• If it includes a voucher, link to it.

Voided transactions

transaction_status can be:

• ACTIVE

• VOID

• VOID_REF

When a transaction is voided, the original is marked VOID and a new reversing transaction is created with status VOID_REF. To avoid double-counting:

• Do not include/display VOID_REF transactions

• Display the VOID transaction crossed out and label it e.g. Gym Check-In +1 pt(VOIDED)