Withdraw from Card
Pull funds from a card back into your wallet.
Withdraws available balance from the card into your project wallet.
Limits
- Minimum
10cents ($0.10). - Full balance withdrawal is supported — no reserve requirement.
Optional header
X-Idempotency-Keystringheader1–64 characters matching [a-zA-Z0-9_-]. Retrying with the same key and the same body returns the original result and never withdraws twice — safe for network-timeout retries. The same key with a different body, or reused on a different cardId, returns 409 Conflict. If the withdrawal definitively failed, the key becomes terminal: retrying it returns 409 — use a new key to make a fresh attempt. Reconcile the outcome any time via GET /operations/{idempotencyKey}. Distinct from X-Nonce, which must be rotated on every retry. See Idempotency.
Path parameters
cardIdstringpathrequiredBody
amountintegerbodyrequiredAmount in cents. Must not exceed the card's available balance.
Response
successbooleanmessagestringoperationIdstringPresent only when X-Idempotency-Key was supplied. Server-side operation id (oaop_…) — persist it, or your own idempotency key, to reconcile via GET /operations/{idempotencyKey}.
{
"amount": 50000
}{
"code": 0,
"message": "SUCCESS",
"data": {
"success": true,
"message": "Withdrawal successful",
"operationId": "oaop_06679ff0a71b4e6e8d14"
}
}