Withdraw from a card
Cards
Withdraw from Card
Move USD from a card back to your company USD wallet.
POST
Withdraw from a card
Overview
POST /cards/{id}/withdraw moves USD from the specified card back to your company’s USD wallet. The card balance decreases immediately on success; the withdrawn funds are credited to the wallet.
When to use it
- Reclaim leftover funds before terminating a card.
- Move funds between cards by withdrawing from one and funding another.
- Recover funds when a customer returns an unused per-diem allowance.
POST /cards/{id}/fund.
Prerequisites
- Card status must be
ACTIVEorFROZEN(you can withdraw from a frozen card to recover funds before terminating it). - The card must belong to your company.
- The card balance must be ≥
amount.
Request
Headers
Path parameters
Body
Response
200 — Success
Error responses
Webhooks fired
card.withdraw— on success.card.withdraw.failed— on permanent failure (e.g. upstream rejected).transaction.withdrawal.completed— once the transaction settles.
Code examples
cURL
Node.js (axios)
Related
POST /cards/{id}/fund— the reverse direction.POST /cards/{id}/terminate— terminating a card auto-refunds the remaining balance, so you don’t need to withdraw first.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json
Amount in USD to withdraw from the card to the company USD wallet. Minimum 1 USD.
Required range:
x >= 1Response
Withdrawal successful