Top Up Card
POST
{{baseUrl}}/api/v1/cards/{cardId}/topup
202 Accepted — the top-up is processed asynchronously.amount must be a positive numbercurrency must match the card's currency (3-letter ISO 4217 code, e.g., "GBP", "USD", "EUR")task_id in the response can be used to track processing statusGET /cards/{cardId}/balance to confirm the updated balance after processing.📋 Request Body Fields
| Field | Type | Description | Constraints |
|---|---|---|---|
amount | number (double) | Amount to load onto the card. Must be positive. Example: 500.0 | - |
currency | string | ISO 4217 currency code. Must match the card's currency. Example: GBP | - |
📤 Response Fields
| Field | Type | Description | Notes |
|---|---|---|---|
card_id | string (uuid) | - | - |
amount | number | - Example: 500.0 | - |
currency | string | - Example: GBP | - |
status | string | Processing status: processing, completed, failed. Example: processing | - |
transaction_id | string | - | nullable |
task_id | string | - | nullable |
performed_at | string (date-time) | - | - |
Request
Path Params
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{baseUrl}}/api/v1/cards/a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11/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"
}'Response Response Example
202 - Success
{
"data": {
"card_id": "a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
"amount": 500,
"currency": "GBP",
"status": "processing",
"transaction_id": "txn_topup_001",
"task_id": "task_001",
"performed_at": "2024-01-15T10:30:00Z"
}
}Modified at 2026-02-18 13:25:10