# 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"](https://lara-script.gitbook.io/docs/ru/funkcional-admin-paneli/obshie/verifikaciya).
* **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.&#x20;

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**

<figure><img src="https://2918865942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0ow3kIXHQDcl9DBdYiM%2Fuploads%2FCsMOhcIUJikFEJAAkIs2%2Fimage.png?alt=media&#x26;token=9aa1f4b2-b253-4966-a461-c92d393668e8" alt=""><figcaption></figcaption></figure>

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

### Getting data from SumSub

#### 1. Registration

[Register](https://cockpit.sumsub.com/checkus/signUp) with the SumSub service.

#### 2. Getting API keys

[Go to the section](https://cockpit.sumsub.com/checkus/devSpace/appTokens):

Next, perform the following actions:

* click **Generate app token**
* as a result, the following will be generated:
  * **Token**
  * **Secret Key**

<figure><img src="https://2918865942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0ow3kIXHQDcl9DBdYiM%2Fuploads%2FyivOznvWbbDG0Bqt1KGp%2Fimage.png?alt=media&#x26;token=78a0172d-2a4f-46dc-a942-a99d44fba2cc" alt=""><figcaption></figcaption></figure>

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:](https://cockpit.sumsub.com/checkus/sdkIntegrations/levels/individual)

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](https://cockpit.sumsub.com/checkus/devSpace/webhooks/webhookManager):

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:

<figure><img src="https://2918865942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0ow3kIXHQDcl9DBdYiM%2Fuploads%2F2TM82lat1r5YjmrtcfCC%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-31%20%D0%BE%2016.48.10.png?alt=media&#x26;token=8edd489b-ad9b-4480-a903-7db40bb55ed7" alt="" width="563"><figcaption></figcaption></figure>

### 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**

<figure><img src="https://2918865942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0ow3kIXHQDcl9DBdYiM%2Fuploads%2FSpvZF2tUBXTAT4qOP3K3%2Fimage.png?alt=media&#x26;token=a53e2e57-3c0a-4fa8-9b5d-8881eb0b4de3" alt=""><figcaption></figcaption></figure>
