Tillo API

Appearance

Choice Links new ​

A Choice Link is a URL which is loaded with a balance, which can be 'cashed out' or 'redeemed' for a number of different Gift Cards.

The Gift Cards available on a Choice Link depends on the configuration of the Choice Link as well as the configuration of your account.

To identify a Choice Link in your Brands API response, look for the type key. Regular brands will have a type of gift-card, and Choice Links will have a type of choice-link.

In the Brands API response, a Choice Link will also display a list of the Brands it can be redeemed for:

json
"choices": [
    "amazon",
    "halfords",
    "ask-italian",
    "costa"
],
"choices": [
    "amazon",
    "halfords",
    "ask-italian",
    "costa"
],

NOTE

The returned choices will not automatically contain all brands available on a Choice Link. Only approved brands that you have added to your account will be returned. Visit the Choice Link's details page in the hub to see which brands may need to be added or requested for approval.

Choice links can be themed to match your brand colors and logo. To set up choice link theming, please contact your Tillo account manager.

You can either have an active theme for all choice links that are created, or when making an API issuance request, you can select a specific theme to be applied to that choice link.

json
{
    "personalisation": {
        "choice_link_theme": "your_theme_reference",
    },
}
{
    "personalisation": {
        "choice_link_theme": "your_theme_reference",
    },
}