Verification links

Create verification links that you can share with your users, code-free

We provide you with the following types of sharable verification links:

Use unilinks

Unilinks are created automatically upon saving the verification level and is unique for each level; you can share this link with multiple applicants. To pass verification, applicants will have to verify their email first. Each email can be used to create only one applicant per level.

To create a unilink:

  1. In the Dashboard, set up a verification level to be used when your applicants open the link.
  2. Open the level and in the Verification link section, click Copy or use the QR code.
  3. Share the link with your applicants to verify their identity without using code.

Under the QR-code section, you can see how many times the link was used to verify applicants. This number is calculated based on the number of email addresses used for verification via a specific link.

πŸ“˜

Note

  • Unilinks are supported only in the WebSDK 1.0.
  • If applicants complete email verification but do not complete document verification and re-open the same link on the same device and in the same browser, email verification will be skipped.
  • If the applicant session expires (currently 30 min) after completing email verification, the applicant will have to repeat email verification.
  • If applicants start the session using a link and then create a personal mobile link which expires, they will be taken back to the email verification step.

You can generate a new unilink at any moment by clicking Generate new.

❗️

Warning

When you generate a new link, the previous one becomes invalid and cannot be used for verification.

Create unilink with Sumsub API

To create a unilink via API, use the following POST method:

curl -X POST \
  'https://api.sumsub.com/resources/sdkIntegrations/levels/basic-kyc-level/websdkLink?ttlInSecs=1800&externalUserId=304775ty&lang=en' \
     -H 'Accept: application/json'
     -H 'Content-Type: application/json' \
     -d '{
             "email": "[email protected]"
         }'
NameTypeRequiredDescription
levelNameStringYesAn applicant level name that you can set up in the Dashboard.
ttlInSecsIntegerYesLink lifetime in seconds.
externalUserIdStringYesAn external user ID, which is a unique user identifier on your side.
localeStringNoWebSDK text language in ISO 639-1 format.
# {body}ObjectNoTop-level information like email or phone.

Response

A sharable URL is returned.

{
    "url": "https://api.sumsub.com/idensic/l/#/lPDnIKwzmxPfDohk"
}

Unilink App

Use the Sumsub unilink app in case you want to use all the benefits of the Sumsub product without having to fully integrate with our MobileSDK.

You can recommend your applicants to download the app from the AppStore or Google Play to go through the verification flow.

For applicants to pass verification:

  1. In the Dashboard, set up a verification level to be used by your applicants.
  2. Open the level and from the Verification link section, do either of the following:
    • Copy the QR code and add it to your website.
    • Copy and directly share the generated link with your applicants.

After your applicants scan the QR code (or follow the shared link) from the app, they are asked to verify their email address by sending a verification code. Once verified, applicants are redirected to the Sumsub SDK to get verified as usual.

πŸ“˜

Info

Do not confuse the Sumsub app with the Sumsub Business app. The latter is meant for demo purposes, while the former is created for common users to go through the verification process as fast and comfortably as possible.

Use permalinks

Permalinks are created by you manually in cases you have not yet integrated with Sumsub, but still want to let your applicants pass identity verification.

You can create two types of permalinks:

  • A permalink based on the external user ID.
  • A set of independent permalinks.

To create permalinks:

  1. Go to the Integrations page in the Dashboard and choose between Individuals and Companies.
  2. Find a level for which you want to generate a permalink.
  3. On the right-hand side of the level record, select WebSDK permalinks.
  4. Continue with the instructions on the screen.

πŸ“˜

Note

Applicants who pass identity verification using permalinks will be associated with your API key, allowing you to obtain applicant data via the Sumsub API or using the Dashboard.

No code