A client’s application enables a user to perform a balance inquiry on a gift card to check its remaining balance. The user selects a card managed or purchased through the application and sends a request to get card balance. Not all gift cards support balance inquiry.
Learn more about how to perform balance inquiries with our Balance Inquiry Tutorials.
The client application can make the following Balance Inquiry Calls based on the use case:
Any Balance Inquiry APIs can be used. This table lists only the most appropriate and economical Balance Inquiry calls for the listed scenarios
|Add physical card and get balance||X|
|Purchase eGift and get Balance||X|
|Get the current balance||X|
|Get the activated balance||X|
|Get the last cached balance||X|
- The supported feature value
UNIVERSAL BALANCE INQUIRYand
PARTIAL_BALANCE_INQUIRYindicates if the balance inquiry is supported.
PARTIAL_BALANCE_INQUIRY=> Balance Inquiry definition that supports only in-network gift cards i.e. cards sold on/by Blackhawk Network platform.
UNIVERSAL BALANCE INQUIRY=> Balance Inquiry definition that supports balance inquiry on out of network gift cards i.e. cards sold out of Blackhawk Network platform.
- The product Line
pinRequiredattribute indicates if the PIN is needed to make a Balance Inquiry call. This field enforces the use of PIN.
- Client application should provide a limit on the Balance Inquiry calls being made by each user per product per day.
- If there is an error or timeout while getting the balance, then the API returns the cached balance. The client application can determine if the balance is current or not by looking at the account
Updated 6 months ago