Withdraw from Card

Move funds from a virtual card back to your wallet

Withdraws funds from a virtual card back to your USD wallet balance.

POST https://api.yativo.com/api/v1/customer/virtual/cards/withdraw

Requires an Idempotency-Key header.

Request Body

cardId · string · required

The virtual card ID to withdraw from.

amount · number · required

Amount to withdraw from the card. Minimum 1.00.

cURL

curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/withdraw' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: withdraw-card-001' \
  -d '{
    "cardId": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "amount": 50
  }'

Success

{
  "status": "success",
  "status_code": 200,
  "message": "Withdrawal successful",
  "data": {
    "card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "amount_withdrawn": "50.00",
    "new_card_balance": "100.00",
    "currency": "USD"
  }
}