Skip to main content
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
Requires an Idempotency-Key header.

​
Request Body

​
customer_id
string
required
The ID of the activated customer. Must exist in your customers table.
​
amount
number
required
Initial funding amount in USD. Minimum 3.00,maximum3.00, maximum 10,000.00.
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
  }'

{
  "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"
  }
}