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 retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "sumsub_link": "https://kyc.sumsub.com/msdk/v2?accessToken=_act-sbx-...",
    "sumsub_sdk_token": "_act-sbx-...",
    "applicant_id": "6627f3a2c5d4e100123abcde",
    "next_step": "kyc_status"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
yativoCardId
string
required
The customer’s yativo_card_id.
Call this endpoint after OTP verification. Open sumsub_link in the customer’s browser or embed it in your app. They will complete identity verification (government ID upload + liveness check) through the hosted Sumsub flow. After completion, poll Check KYC Status until kyc_status is approved — KYC completion is not delivered as a webhook.
Link expiry: The Sumsub link is valid for 1 hour from when it was generated. If the customer has not completed KYC within that window, call this endpoint again — a fresh link is returned automatically. You do not need to pass any extra parameters to force a refresh.
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 retrieved",
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "sumsub_link": "https://kyc.sumsub.com/msdk/v2?accessToken=_act-sbx-...",
    "sumsub_sdk_token": "_act-sbx-...",
    "applicant_id": "6627f3a2c5d4e100123abcde",
    "next_step": "kyc_status"
  }
}