Balances at Clutch are managed via Value Type configuration. A given card can contain one to many different balances, where a balance can be:
- Currency (USD, EUR, CAN, KRW, and many more)
- Points
- Punches
- Cashback
- Lifepoints (for tracking lifetime points accrual)
- Custom
The Clutch platform is flexible enough to support unlimited Custom currencies, including anything from Slice of Pizza to Free Hat to Season Tickets.
To issue and redeem balances directly on a given card outside of a purchase (which should be managed using our checkout call), you should use the updateBalance API. Provided a card number is present along with the correct combination of balanceCode, balanceType, and amount, you can issue or redeem balance simply by specifying an action of “issue” or “redeem.
To issue balances that expire, include the issuedBalanceExpiration field with the desired expiration date in the format yyyy-MM-dd HH:mm:ss and the UTC (+0:00) timezone.
To see available Value Types, call our listValueType API.
