Skip to main content
Registers a customer for virtual card creation. This enrollment step is required before issuing any virtual cards to the customer. Fields that are already stored on the customer’s profile may be omitted. 
POST https://api.yativo.com/api/v1/customer/virtual/cards/activate
Requires an Idempotency-Key header.

​
Request Body

​
customer_id
string
required
The ID of the customer to activate. Must exist in your customers table.
​
user_photo
string
Customer photo (base64 or URL). Required if not already on the customer’s profile.
​
idType
string
Government ID type (e.g. "passport", "drivers_license", "national_id"). Required for Nigerian customers.
​
customer_idFront
string
Front image of the customer’s government-issued ID. Required if not already on the customer’s profile.
​
customer_idNumber
string
Government-issued ID number. Required if not already on the customer’s profile.
​
customer_address
object
Customer address. Each sub-field is required if not already on the customer’s profile.
curl -X POST 'https://api.yativo.com/api/v1/customer/virtual/cards/activate' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -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."
}