> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Top Up Card

> Fund a virtual card from your USD wallet balance

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
```

<Note>
  Requires an `Idempotency-Key` header.
</Note>

## Request Body

<ParamField body="cardId" type="string">
  The virtual card ID to fund. Either `cardId` or `card_id` must be provided.
</ParamField>

<ParamField body="card_id" type="string">
  The virtual card ID to fund. Either `cardId` or `card_id` must be provided.
</ParamField>

<ParamField body="amount" type="number" required>
  Amount to add to the card. Minimum 1.00, maximum 10,000.00 (USD).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  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
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>