Get Customer 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"
  }
}

GET

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"
  }
}

Check Customer KYC Status Verify Customer OTP