Top-up Physical Card

post

https://sandbox.tillo.dev/api/v2/physical/top-up

Top up a physical gift card using the gift card number or serial number.

The serial_number property is required for certain brands using specific processors.

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

sector

string

enum

required

length ≥ 1

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

code

string

required

length between 8 and 110

^[a-zA-Z0-9 ._-]+$

Physical card number (8-110 characters, alphanumeric with spaces, periods, underscores, and hyphens)

string

length between 3 and 20

^[a-zA-Z0-9_-]+$

Gift card PIN. Required for certain brands.
Must be between 3 and 20 characters when provided.
Allowed characters: alphanumeric, underscore, hyphen.

serial_number

string

length ≥ 1

Gift card serial number. Required for certain brands.
Must be at least 1 character when provided.

200Successful Response