KYC Sharing with Sumsub

Read KYC Overview as it covers why we use Sumsub and the full KYC status lifecycle. This guide covers how to share a user’s already-verified identity with a partner via Sumsub.

If a user has already completed KYC with Gnosis Pay, that verified identity can be reused rather than requiring the user to go through verification again with a partner. This is done by generating a temporary Sumsub share token, which the partner uses on their end to import the applicant’s already-verified data. Generates a temporary Sumsub share token for the authenticated user’s KYC applicant. Pass this token to the named Sumsub recipient (the partner) to reuse the applicant’s verified identity data.

Sandbox
Production

    curl --request POST \
      --url https://core.sandbox.gnosispay.in/user-api/kyc/import-partner-applicant \
      --header 'Authorization: Bearer <token>' \
      --header 'Content-Type: application/json' \
      --data '{
        "forClientId": "<string>",
        "ttlInSecs": 1200
      }'

    curl --request POST \
      --url https://core.prod.gnosispay.com/user-api/kyc/import-partner-applicant \
      --header 'Authorization: Bearer <token>' \
      --header 'Content-Type: application/json' \
      --data '{
        "forClientId": "<string>",
        "ttlInSecs": 1200
      }'

The share token is single-use and expires after ttlInSecs (or Sumsub’s default of 1200 seconds if not specified). Generate a new token for each sharing attempt — it cannot be reused once consumed or expired.

Getting started

Authentication & Onboarding

KYC Sharing

Manage Accounts

Manage Cards

Secure Card Elements via PSE

Webhooks

KYC Sharing with Sumsub

​Generate KYC Applicant Share Token

Generate KYC Applicant Share Token