This article presents possible use cases and corresponding sample flows that you can support. These can be helpful jumping off points as you plan your implementation.
You can create gift cards for promotional campaigns and automatically send them to recipients with personalized messages. This allows businesses to run marketing campaigns or provide customer service compensation.
To create and send promotional gift cards:
Create a gift card with recipient notification settings. Include the sender and recipient information along with a personalized message for the campaign.
Call Send Gift Card Email to deliver the gift card immediately, or schedule it for later delivery by setting the notification date.
Track the gift card status using Get Gift Card to monitor when it's redeemed.
Customer service representatives often need to create, search, and manage gift cards for various support scenarios. This workflow demonstrates building a comprehensive management interface.
To create gift cards for customer service scenarios:
Create a gift card without notification info for immediate customer use. Use a descriptive code that includes a customer service reference.
Provide the full gift card code to the customer from the response (only available in the creation response).
Record the gift card ID in your customer service system for future reference.
To help customers find and manage their gift cards:
Use List Gift Cards by Email to find gift cards associated with a customer's email address.
For more specific searches, use Search Gift Cards with partial code matching by filtering on the code suffix.
If a gift card needs to be deactivated due to fraud or customer request, call Disable Gift Card.
Allow customers to check their gift card status and balance using a self-service interface.
To implement gift card lookup:
Accept the gift card code from the customer (use the code suffix for partial matching if needed).
Call Search Gift Cards to find the gift card by filtering on the code suffix and sorting by creation date.
Display the gift card balance, expiration date, and status to the customer from the search results.
Create comprehensive reports for business intelligence and financial auditing by aggregating gift card data.
To generate gift card reports:
Call Query Gift Cards to retrieve gift cards for a specific time period by filtering on creation date ranges and sorting chronologically.
Use Count Gift Cards to get total counts for different gift card categories, such as active gift cards with remaining balances.
Aggregate the data to create reports showing total gift card value issued and outstanding balances.