When purchasing gift cards, it’s important to know if the gift card you are purchasing is eligible for use in your country. In this guide, you will learn how to view only gift cards that can be used in your country. This guide is broken down into the following steps:
- Getting your access token
- Getting the gift cards available in your country
You can get your access token by following the steps in this quickstart.
Getting the gift cards available in your country
Suppose you are located in the United Arab Emirates (UAE) and you want to identify the gift cards that can be used in your country. With the UAE’s two letter ISO code, you can make a request via the GiftCard API to fetch every gift card eligible for use in the UAE. The cURL code sample below shows you how to achieve this
curl -i -X GET \
https://giftcards-sandbox.reloadly.com/countries/AE/products \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
If successful, you should receive a JSON response containing eligible gift cards for use in the UAE.
[
{
"productId": 9,
"productName": "Amazon UAE",
"global": false,
"senderFee": 285,
"discountPercentage": 1.2,
"denominationType": "FIXED",
"recipientCurrencyCode": "AED",
"minRecipientDenomination": null,
"maxRecipientDenomination": null,
"senderCurrencyCode": "NGN",
"minSenderDenomination": null,
"maxSenderDenomination": null,
"fixedRecipientDenominations": [],
"fixedSenderDenominations": [],
"fixedRecipientToSenderDenominationsMap": {},
"logoUrls": [],
"brand": {},
"country": {},
"redeemInstruction": {}
},
{
"productId": 24,
"productName": "App Store & iTunes UAE",
"global": false,
"senderFee": 285,
"discountPercentage": 0,
"denominationType": "FIXED",
"recipientCurrencyCode": "AED",
"minRecipientDenomination": null,
"maxRecipientDenomination": null,
"senderCurrencyCode": "NGN",
"minSenderDenomination": null,
"maxSenderDenomination": null,
"fixedRecipientDenominations": [],
"fixedSenderDenominations": [],
"fixedRecipientToSenderDenominationsMap": {},
"logoUrls": [],
"brand": {},
"country": {},
"redeemInstruction": {}
},
{
"productId": 3167,
"productName": "Free Fire 100 + 10 Diamond AE",
"global": false,
"senderFee": 285,
"discountPercentage": 2.9,
"denominationType": "FIXED",
"recipientCurrencyCode": "USD",
"minRecipientDenomination": null,
"maxRecipientDenomination": null,
"senderCurrencyCode": "NGN",
"minSenderDenomination": null,
"maxSenderDenomination": null,
"fixedRecipientDenominations": [],
"fixedSenderDenominations": [],
"fixedRecipientToSenderDenominationsMap": {},
"logoUrls": [],
"brand": {},
"country": {},
"redeemInstruction": {}
}
]
