Skip to main content
Adds funds to a virtual card. The amount is always debited from your USD wallet. 
POST https://api.yativo.com/api/v1/customer/virtual/cards/topup
Requires an Idempotency-Key header.

​
Request Body

​
cardId
string
The virtual card ID to fund. Either cardId or card_id must be provided.
​
card_id
string
The virtual card ID to fund. Either cardId or card_id must be provided.
​
amount
number
required
Amount to add to the card. Minimum 1.00, maximum 10,000.00 (USD).
curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/topup' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: topup-card-001' \
  -d '{
    "cardId": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "amount": 100.00
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "Card topped up successfully",
  "data": {
    "card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "amount_added": "100.00",
    "new_balance": "250.00",
    "currency": "USD"
  }
}