User verification

In this section, you can configure the method for completing identity verification on the website.

In the field Verification provider you can choose one of two options:

• Classic — standard built-in verification through the website, when using which clients on the web part of your website, while completing identity verification, will wait for manual moderation through the admin panel, and will appear in the general list of the "General" section - "Verifications".

• SumSub (Sum & Substance) — a third-party KYC provider that automates user verification (documents, selfie, video verification) and makes a decision automatically (approve / reject) almost instantly.

Depending on the selected option, the verification process changes.

Classic mode

When selecting Classic mode:

• the verification process does not change

• user requests are displayed in the section: General → Verifications

SumSub mode

When selecting SumSub additional configuration fields appear:

• API key

• Secret API key

• KYC level

• Webhook Secret

• Webhook URL

To configure the SumSub functionality correctly, follow the steps described below:

Getting data from SumSub

1. Registration

Register with the SumSub service.

2. Getting API keys

Go to the section:

Next, perform the following actions:

• click Generate app token

• as a result, the following will be generated:

  • Token

  • Secret Key

The obtained values must be specified in the admin panel:

• API key → Token

• Secret API key → Secret Key

3. Configuring the verification level (KYC Level)

Go to the verification levels section:

Next:

• create a new level or choose an existing one (for example: id-only)

• configure the necessary verification parameters (documents, selfie, video, etc.)

• in the SumSub system, the level corresponds to KYC configuration

More about this section in the documentation: https://docs.sumsub.com/docs/verification-levels

The obtained level value must be specified in the admin panel in the field: KYC level

4. Webhook setup

Go to the webhook manager:

Next, create a webhook with the following parameters:

• Name — any name (does not affect system operation)

• Webhook receiver — HTTP address

• Target — https://<domain>/api/v1/user-verification/sumsub/webhook (the URL can be taken from the field Webhook URL in the admin panel)

• Webhook types — you can select all or the required events

• Applicant types — Individual

• Secret key — need to copy and then specify in the admin panel (section Webhook Secret)

• Signature algorithm — SHA256

• Resend failed webhooks several times — enabled

Webhook documentation: https://docs.sumsub.com/docs/webhooks

After saving:

• return to the admin panel

• fill in all admin panel fields with the obtained data

• click "Save"

• go back to the SumSub page and click Test webhook

Expected result:

User verification process

After setting up SumSub:

1. The user completes verification in the personal account

2. A redirect to SumSub occurs

3. User:

   • selects a country

   • selects the document type

   • uploads documents

   • (optional) completes video verification

4. The system automatically makes a decision (approve / reject) and automatically updates the verification status in the Personal Account

Displaying results

• Requests are not displayed in the section: General → Verifications

• The verification result is available in: General → Users

Additionally:

• the field has appeared Verification provider

• for such users, the following will be displayed: SumSub