Skip to main content
GET
/
v1
/
yativo-card
/
customers
/
{yativoCardId}
/
kyc-link
curl -X GET 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/kyc-link' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "message": "KYC link generated. Open the link to complete identity verification.",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_url": "https://kyc.yativo.com/verify?token=eyJhbGciOiJSUzI1NiJ9...",
    "next_step": "kyc_status",
    "instructions": "Direct the customer to open this URL to upload their government ID and complete liveness check"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
yativoCardId
string
required
The customer’s yativo_card_id.
Call this endpoint after OTP verification. The returned kyc_url should be opened by the customer in their browser or embedded in your app. They will complete identity verification (government ID upload + liveness check) through the hosted flow. After completion, poll Check KYC Status until kyc_status is approved — KYC completion is not delivered as a webhook.
curl -X GET 'https://crypto-api.yativo.com/api/v1/yativo-card/customers/yativo_card_customer_8f9a..._1769031332068/kyc-link' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "message": "KYC link generated. Open the link to complete identity verification.",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "kyc_url": "https://kyc.yativo.com/verify?token=eyJhbGciOiJSUzI1NiJ9...",
    "next_step": "kyc_status",
    "instructions": "Direct the customer to open this URL to upload their government ID and complete liveness check"
  }
}