curl -X POST "{{base_url}}/card/withdraw" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"amount": 10
}'
{
"code": 200,
"message": "Card withdrawn successfully.",
"data": {
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"title": "Ada Lovelace",
"color": "black",
"name": "ADA LOVELACE",
"brand": "visa",
"currency": "USD",
"balance": "15.00",
"status": "active",
"mask": "424242******4242",
"last4": "4242",
"expiration": "12/28",
"is_non_subscription": true,
"is_contactless_payment": false,
"is_physical": false,
"billing_address": null,
"last_used_on": null,
"created_at": "2026-11-07T08:00:00+00:00",
"updated_at": "2026-11-07T09:10:00+00:00"
}
}
Cards
Withdraw from card
Debit a cardholder’s open card. Amount must be greater than 0.9.
POST
/
card
/
withdraw
curl -X POST "{{base_url}}/card/withdraw" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"amount": 10
}'
{
"code": 200,
"message": "Card withdrawn successfully.",
"data": {
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"title": "Ada Lovelace",
"color": "black",
"name": "ADA LOVELACE",
"brand": "visa",
"currency": "USD",
"balance": "15.00",
"status": "active",
"mask": "424242******4242",
"last4": "4242",
"expiration": "12/28",
"is_non_subscription": true,
"is_contactless_payment": false,
"is_physical": false,
"billing_address": null,
"last_used_on": null,
"created_at": "2026-11-07T08:00:00+00:00",
"updated_at": "2026-11-07T09:10:00+00:00"
}
}
Debits
amount from the cardholder’s open card. amount must be greater than 0.9.
The response is a card object without card_number or security_code. balance is the balance after the debit.
string
required
Cardholder id returned by create card user.
number
required
Amount to remove, in the card currency. Must be greater than
0.9.Errors
| Message | When |
|---|---|
| First validator error | user_id is missing or amount is not greater than 0.9 |
Card user not found. | user_id is missing for this partner |
Card not found. | The cardholder has no open card |
Card has insufficient balance. | The card cannot cover amount |
Partner not found. | The API key does not match a partner |
An unexpected error occurred. Please try again. | The withdrawal could not be completed |
curl -X POST "{{base_url}}/card/withdraw" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"amount": 10
}'
{
"code": 200,
"message": "Card withdrawn successfully.",
"data": {
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"title": "Ada Lovelace",
"color": "black",
"name": "ADA LOVELACE",
"brand": "visa",
"currency": "USD",
"balance": "15.00",
"status": "active",
"mask": "424242******4242",
"last4": "4242",
"expiration": "12/28",
"is_non_subscription": true,
"is_contactless_payment": false,
"is_physical": false,
"billing_address": null,
"last_used_on": null,
"created_at": "2026-11-07T08:00:00+00:00",
"updated_at": "2026-11-07T09:10:00+00:00"
}
}