Tillo APIAppearance
Tags and Sectors
The Tillo API transaction calls all allow additional metadata to be supplied and recorded against each individual transaction that can be used for reporting.
Tags
We provide partners with a way of supplying additional information in order to search/filter transactions in the hubs and produce sales reports by tag. Tags are private to you and will not be shared with brands and intended to allow you to categorise/group your sales by common themes e.g. a particular client or type of user.
These take the form of an array of tags e.g.
json
"tags": ["tag1", "tag2", "tag3"]"tags": ["tag1", "tag2", "tag3"]1
Sectors
The sector of a sale will be shared with Brands to allow them to see the channels their gift cards are being distributed in to. You will most likely fall into one or more of these sectors which is agreed with Tillo during your integration. You must supply a sector per sale.
| Sector name | Sector identifier | Sector description |
|---|---|---|
| Aggregator | aggregator | Used for initiatives catering to diverse needs, consolidating a variety of gift card use-cases into a single interface. |
| B2C Marketplace | b2c-marketplace | Used when there is an exchange of unwanted gift cards, facilitating the redistribution of gift card assets. |
| Cash Out | cash-out | Used when the gift card purchase allow customers to convert earnings, points, or prize winnings into gift cards. |
| Cashback | cashback | Used for initiatives where consumers earn tangible 'cash' rewards when making purchases of gift cards. |
| Consumer Rewards and Incentives | consumer-rewards-and-incentives | Used for initiatives where the gift card is being used for rewards and incentives, customer acquisition, engagement, activation, and loyalty. |
| Crypto Off-ramp | crypto-off-ramp | Used for Crypto-focused initiatives enabling customers to smoothly transition cryptocurrency holdings into gift cards for use on everyday purchases. |
| Employee Benefits | employee-benefits | Used for initiatives that offer a range of non-cash benefits to employees, from health and wellness to lifestyle perks. |
| Employee Rewards and Incentives | employee-rewards-and-incentives | Used for initiatives that acknowledge employee performance through a variety of rewards such as cash, gift cards, and experiences. |
| Gift Card Mall | gift-card-mall | Used for initiatives where consumers are presented with a wide array of full-value gift cards, offering a diverse selection to cater to various preferences and needs. |
| Other | other | Used where gift cards serve as an alternative benefit option accommodating various scenarios beyond specific categorisations. |
| Relief Support and Disbursement | relief-support-and-disbursement | Used for initiatives designed to facilitate government or charity organisations in the secure and efficient distribution of welfare benefits. |