Path Parameters
Response
Indicates if the card was closed successfully
Amount returned to wallet from card balance
Transaction ID for the balance withdrawal (if any)
New wallet balance after balance return
curl -X PATCH https://api.uncash.io/api/v1/cards/123/close \
-H "Authorization: Bearer uc_your_api_token_here"
{
"success": true,
"data": {
"card_id": "123",
"balance_withdrawn": 50.75,
"transaction_id": "txn_456789",
"new_wallet_balance": 1300.75
},
"message": "Card closed successfully",
"timestamp": "2025-09-26T10:30:00.000Z"
}
Balance Refund: Any remaining balance on the card is automatically returned to your wallet when the card is closed. This operation cannot be undone.
Rate Limiting: Must wait 15 minutes between withdrawals. This applies to card closures that trigger automatic balance withdrawals.
Error Responses
{
"success": false,
"message": "Card not found or you do not have permission to close this card",
"timestamp": "2025-08-03T10:00:00.000Z"
}