curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
Virtual Cards
Create Virtual Card
Issue a virtual prepaid card to an activated customer
POST
/
customer
/
virtual
/
cards
/
create
curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
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.curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Body
application/json