Issue Digital Gift Card

post

https://sandbox.tillo.dev/api/v2/digital/issue

Issue a new digital gift card

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

client_request_id

string

required

length between 5 and 50

^[A-Za-z0-9_-]+$

Unique identifier for this request. Also acts as an idempotency key

brand

string

required

length between 1 and 255

^[a-z0-9-]+$

Brand identifier/slug (lowercase letters, numbers, hyphens only). Must be a brand connected to your buyer account.

face_value

object

required

delivery_method

string

enum

required

length ≥ 3

Allowed:

fulfilment_by

string

enum

required

This parameter dictates who will be responsible for sending out the confirmation email once a gift card has been issued. If you are planning on sending out the email please set this to 'partner', if you would like us to fulfil the email for you then please provide 'rewardcloud' as the value. Please note, that when we are fulfilling the email on your behalf you will need to provide the additional 'fulfilment_parameters' field

Allowed:

sector

string

enum

required

length ≥ 1

Must match one of the sectors configured for your buyer account.

personalisation

object

fulfilment_parameters

object

Fulfilment parameters are required when you want Tillo to send the issuance email on your behalf

200Standard Issue Digital Code

400Bad Request

401Authentication failed. Invalid API key, signature, or timestamp.

422Validation error. Request data failed validation rules.

429Too many requests. Rate limit exceeded.

500Internal Server Error

503Service Unavailable