curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/activate' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: activate-da44a3e6-001' \
-d '{
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"user_photo": "https://example.com/photo.jpg",
"idType": "passport",
"customer_idFront": "https://example.com/id-front.jpg",
"customer_idNumber": "A12345678",
"customer_address": {
"country": "US",
"city": "New York",
"state": "NY",
"zipcode": "10001",
"street": "Main St",
"number": "123"
}
}'
{
"success": "User registered successfully."
}
Activate Customer for Virtual Cards
Enroll a customer in the virtual card program
curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/activate' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: activate-da44a3e6-001' \
-d '{
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"user_photo": "https://example.com/photo.jpg",
"idType": "passport",
"customer_idFront": "https://example.com/id-front.jpg",
"customer_idNumber": "A12345678",
"customer_address": {
"country": "US",
"city": "New York",
"state": "NY",
"zipcode": "10001",
"street": "Main St",
"number": "123"
}
}'
{
"success": "User registered successfully."
}
POST https://api.yativo.com/api/v1/customer/virtual/cards/activate
Idempotency-Key header.curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/activate' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: activate-da44a3e6-001' \
-d '{
"customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
"user_photo": "https://example.com/photo.jpg",
"idType": "passport",
"customer_idFront": "https://example.com/id-front.jpg",
"customer_idNumber": "A12345678",
"customer_address": {
"country": "US",
"city": "New York",
"state": "NY",
"zipcode": "10001",
"street": "Main St",
"number": "123"
}
}'
{
"success": "User registered successfully."
}
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
The ID of the customer to activate. Must exist in your customers table.
Customer photo (base64 or URL). Required if not already on the customer's profile.
Government ID type (e.g. "passport", "drivers_license", "national_id"). Required for Nigerian customers.
passport, drivers_license, national_id Front image of the customer's government-issued ID. Required if not already on the customer's profile.
Government-issued ID number. Required if not already on the customer's profile.
Customer address. Each sub-field is required if not already on the customer's profile.
Show child attributes
Show child attributes
Response
Customer registered for virtual cards
"User registered successfully."