Unload Card
Cards
Unload Card
Withdraw remaining balance from a card back to your business wallet. POST /cards//unload.
POST
Unload Card
Overview
Withdraw funds from a card back to your business wallet. An unloading fee may apply based on your pricing configuration.Path Parameters
Request Body
Example Usage
Asynchronous Processing
Card unloading is processed asynchronously by the card provider. A2xx response confirms only that the request was accepted and submitted — the funds are not yet credited, and the operation can still be rejected downstream.
- When the provider confirms the unload, a
card.unloadedwebhook is sent and the net amount is credited to your business wallet. - If the provider rejects the unload, a
card.unloading_failedwebhook is sent and no funds are credited.
reference you supplied (it is returned in both the response and the webhook).
Treat the immediate response as “request accepted”, never as “completed”. Use the
card.unloaded / card.unloading_failed webhooks — not the synchronous response — as the source of truth for the final status.Error Responses
A2xx response is an acceptance, not a settlement (see Asynchronous Processing). These errors are returned synchronously when the request cannot even be submitted:
Authorizations
JWT access token obtained from /auth/token
Path Parameters
Body
application/json

