Top Up Card

POST

/{{baseurl}}/api/v1/cards/{cardId}/topup

Loads funds onto a card.

⚠️ Required Fields

Field	Type	Description	Constraints
`amount`	`number`	Amount to load. Must be > 0	Min: 0.01
`currency`	`string`	ISO 4217 code matching the card's currency	-

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢202

Top-up accepted for processing.

This response does not have a body.

🟠401

🟠404

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST '/{{baseurl}}/api/v1/cards//topup' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "amount": 500,
    "currency": "GBP"
}'

Modified at 2026-02-19 17:53:55

Update Card Limits

Get Card Balance