Migrating from API V1 ​

Version 2 of our API is intended to be an incremental improvement from v1, keeping core concepts the same so that the transition path is as straightforward as possible.

The key changes are;

• New authentication mechanism using HMAC in a HTTP Header - credentials can be managed in the hub.
• When issuing a digital gift code, if a brand requires a barcode it is returned in the response data.
• Provide a new call to check your monies on account / credit balances.
• Provide a new call to retrieve brand templates & assets programmatically.
• More consistent naming of variables in the request and response JSON.
• Moved personalisation data from additionalParams and split it between fulfilment information (where Tillo is delivering the gift card to the end recipient) and personalisation information for the template

Rather than issuing a /connect request to retrieve an API Token that is sent in the each subsequent request, each request is authenticated. This removes the need to cache an API Token, refresh it every day, handle expired tokens, and share it across servers.