Fund Card
Move funds from your wallet onto a card.
Transfers funds from your project wallet to the specified card.
Limits
- Minimum
100cents ($1.00). - Maximum
4000000cents ($40,000.00) per transaction.
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 funds the card twice — safe for network-timeout retries. The same key with a different body, or reused on a different cardId, returns 409 Conflict. If the funding 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.
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": 100000
}{
"code": 0,
"message": "SUCCESS",
"data": {
"success": true,
"message": "Card funded successfully",
"operationId": "oaop_65dc71de43174896ae57"
}
}Verify GET /wallet/balance before funding in bulk — funding fails if the wallet has insufficient balance.