Order Physical Card

post

https://sandbox.tillo.dev/api/v2/physical/order-card

Order a physical 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

shipping_method

string

enum

required

Shipping method identifier. Must be a valid shipping method for the fulfilment house. Returns 400 if the shipping method is not available for the fulfilment house.

Allowed:

fulfilment_by

const

enum

required

When ordering a physical gift card, this must be set to rewardcloud

Allowed:

fulfilment_parameters

object

required

personalisation

object

sector

string

enum

required

length ≥ 1

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

200Successful Response

400Bad Request

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

422Validation error. Request data failed validation rules.