Skip to main content
POST
/
api
/
v1
/
cards
/
{id}
/
withdraw
curl -X POST https://api.uncash.io/api/v1/cards/123/withdraw \
  -H "Authorization: Bearer uc_your_api_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50.00
  }'

{
  "success": true,
  "data": {
    "card_id": "123",
    "transaction_id": "txn_456789",
    "new_balance": 150.00,
    "amount_withdrawn": 50.00,
    "wallet_balance": 1250.00
  },
  "message": "Withdrawal successful",
  "timestamp": "2025-09-26T10:30:00.000Z"
}

​
Path Parameters

​
id
string
required
The card ID to withdraw from

​
Body Parameters

​
amount
number
required
Amount to withdraw from the card (minimum: 1.00, maximum: 10,000.00)

​
Response

​
success
boolean
Indicates if the withdrawal was successful
​
data
object
​
message
string
Success message
curl -X POST https://api.uncash.io/api/v1/cards/123/withdraw \
  -H "Authorization: Bearer uc_your_api_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50.00
  }'

{
  "success": true,
  "data": {
    "card_id": "123",
    "transaction_id": "txn_456789",
    "new_balance": 150.00,
    "amount_withdrawn": 50.00,
    "wallet_balance": 1250.00
  },
  "message": "Withdrawal successful",
  "timestamp": "2025-09-26T10:30:00.000Z"
}

​
Validation Rules

  • Minimum amount: $1.00
  • Maximum amount: $10,000.00
  • Decimal places: Maximum 2 decimal places
  • Card balance: Withdrawal amount cannot exceed current card balance
  • Card type: Only FinUp cards support withdrawals
  • Rate limiting: Must wait 15 minutes between withdrawals
Atomic Operation: The withdrawal process is atomic - it either succeeds completely or fails completely. Your card is only debited if the wallet credit succeeds.

​
Error Responses

{
  "success": false,
  "message": "Insufficient card balance. Available: 25.50",
  "timestamp": "2025-08-20T10:00:00.000Z"
}