How to view discounts on gift cards available in your country

Raphael Ugwu

Raphael Ugwu

2 min

When purchasing gift cards via Reloadly’s API – you can benefit from great discount deals on some gift cards. This guide aims to show you how you can view discounts available to gift cards that can be used within your country. Steps to be taken in this guide are

  • Getting your access token
  • Getting the discounted gift cards available in your country

You can get your access token by following the steps in this quickstart.

Getting the discounted gift cards available in your country

Assuming you were located in Portugal and were looking to access discounts on every gift card eligible for use in Portugal, you can achieve this by making a request using Portugal’s two letter ISO code to make a request via the GiftCard API and retrieve a list of suitable gift cards.

Below is a cURL code sample that shows how to make this request

curl -i -X GET \
  https://giftcards-sandbox.reloadly.com/countries/PT/products \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

If successful, you will receive a JSON response containing details of gift cards that can be used in Portugal.

[
  {
    "productId": 18,
    "productName": "App Store & iTunes Portugal",
    "global": false,
    "senderFee": 285,
    "discountPercentage": 2.9,
    "denominationType": "FIXED",
    "recipientCurrencyCode": "EUR",
    "minRecipientDenomination": null,
    "maxRecipientDenomination": null,
    "senderCurrencyCode": "NGN",
    "minSenderDenomination": null,
    "maxSenderDenomination": null,
    "fixedRecipientDenominations": [
      5,
      10,
      15,
      25,
      50
    ],
    "fixedSenderDenominations": [
      2978.95,
      5957.9,
      8936.85,
      14894.75,
      29789.5
    ],
    "fixedRecipientToSenderDenominationsMap": {
      "5.00": 2978.95,
      "10.00": 5957.9,
      "15.00": 8936.85,
      "25.00": 14894.75,
      "50.00": 29789.5
    },
    "logoUrls": [
      "https://cdn.reloadly.com/giftcards/efff4800-085b-463e-818b-64d22c599f8a.jpg"
    ],
    "brand": {
      "brandId": 3,
      "brandName": "App Store & iTunes"
    },
    "country": {
      "isoName": "PT",
      "name": "Portugal",
      "flagUrl": "https://s3.amazonaws.com/rld-flags/pt.svg"
    },
    "redeemInstruction": {
      "concise": "Go to apple.com/redeem to add to your Apple Account balance.",
      "verbose": "Use it for purchases at any Apple Store location, on the Apple Store-app, apple.com, the App Store, iTunes, Apple Music, Apple TV, Apple News, Apple Books, Apple Arcade, iCloud, and other Apple properties. 
Use the Apple Gift Card for App Store, iTunes, iPhone, iPad, Air-pods, Mac book, accessories, and more. 
No returns or refunds on Apple Gift Cards. Terms apply. 
The Apple Gift Card can be used two ways: 
For online purchases, go to apple.com/redeem to add to your Apple Account balance. 
Bring this email to any Apple Store location. 
Beware of gift card scams. Do not share your code. Terms & Conditions Valid only for U.S. transactions in Apple properties. For assistance, visit support.apple.com/giftcard or call 1-800-275-2273. Not redeemable at Apple resellers or for cash, and no resale, refunds, or exchanges, except as required by law. Apple is not responsible for unauthorized use. Terms apply"
    }
  }
]

In the response above, you will notice a discountPercentage property with the value 2.9. This implies the discount in percentage form applied to App Store & iTunes gift cards used in Portugal. This means that if you spend $100 on such a gift card, you will get a cash back value of $2.9 to your wallet.

Resources

Reloadly Gift Card API

Reloadly Developer Documentation

This might also interest you:

Content by developers to developers.

Subscribe to The Monthly Reload for Developers and start receiving all the developers’ updates.

The Monthly Reload: the newsletter for you

Subscribe to our Newsletter and don’t miss any news about our industry and products.

It’s time to build, make your first API call today