Cancel Top-up on a Physical Card

delete

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

Cancel a top-up on a physical gift card using the gift card number. Some brands will additionally require a PIN number.

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

original_client_request_id

string

required

length between 5 and 50

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

This field will be the client_request_id provided in the original transaction. For example, if you are performing some form of cancellation, then this would be the client_request_id you provided when making the original issuance request

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

code

string

required

length between 8 and 110

^[a-zA-Z0-9:_\-:\/]+$

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.

sector

string

enum

required

length ≥ 1

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

Responses

502

Bad Gateway. No response body is returned.

504

Gateway Timeout. No response body is returned

200Successful Response

400Bad Request. Invalid or missing required parameters.

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

422Validation error. Request data failed validation rules.

500Internal server error. Error returned by the processor.