> ## 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.

# Create Virtual Card

> Issue a virtual prepaid card to an activated customer

Creates a virtual card for a customer who has been activated for the virtual card program. The initial funding amount is debited from your USD wallet.

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

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

## Request Body

<ParamField body="customer_id" type="string" required>
  The ID of the activated customer. Must exist in your customers table.
</ParamField>

<ParamField body="amount" type="number" required>
  Initial funding amount in USD. Minimum $3.00, maximum $10,000.00.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/create' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Content-Type: application/json' \
    -H 'Idempotency-Key: card-create-da44a3e6-001' \
    -d '{
      "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
      "amount": 10.00
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "status": "success",
    "status_code": 201,
    "message": "Virtual card created successfully",
    "data": {
      "card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
      "card_number": "4111 **** **** 1234",
      "expiry": "04/29",
      "currency": "USD",
      "balance": "10.00",
      "status": "active",
      "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
      "created_at": "2026-04-01T10:00:00Z"
    }
  }
  ```
</ResponseExample>