Top-up Digital Code

post

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

Top up a digital gift card using the gift card number and pin.

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

Please note, not all brands support the ability to top up. You can determine which brands are eligible for top-up by checking whether they have the digital_top_up transaction type from the GET /api/v2/brands endpoint.

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.

reference

uuid

Unique reference for this transaction

code

string

required

length between 8 and 110

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

Gift card code. Must be between 8 and 110 characters.
Allowed characters: alphanumeric, space, period, underscore, hyphen.

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

400Bad Request. Invalid or missing required parameters.

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

422Validation error. Request data failed validation rules.

429Too many requests. Rate limit exceeded.

500Internal server error. Error returned by the processor.