Skip to main content

8. Configurations: Verification levels

In Configurations, Verification Levels play a key role in managing the client verification process. Each client type (e.g., Personal or Business) can have its own set of verification levels, which are linked to different verification statuses. These levels determine how a client progresses through authentication, ensuring compliance with KYC (Know Your Customer) requirements.

Use Cases
  • Multi-Step KYC: A financial institution might define levels like “Email,” “Phone,” “Identity,” each with statuses from init to approved.
  • Business vs. Personal Clients: Verification steps can differ—business accounts may need more documents and thus more levels.
  • Automation & Compliance: The CRM can automatically update a client’s “verified” status once they hit a particular level/status threshold (e.g., “email/pending” or “identity/approved”).
1. Accessing Verification Levels

Permissions Required:

  • View Tab: (verification.levels.view) right must be true.
  • Edit Verification Levels: (verification.levels.edit) right must be true.
  • Delete Verification Levels: (verification.levels.delete) right must be true.

Verification Levels Tab

image.png

Along the top, click Verification Levels.

image.png

The left panel shows existing Verification levels (e.g., Test, Email, Phone, Identity), each labeled with a client type (e.g., “Personal”).

2. Creating or Editing a Verification Level

1. Click “+ Add”

image.png

A form titled “Add verification level” appears.

image.png

Type: Select the client type (e.g., Business or Personal) that this verification level applies to.

Label / Name: Provide a unique identifier (e.g., “email,” “phone,” “KYC step 1”).

Properties & Language: Optionally enter custom fields or translations.

2. Save the Verification Level

Once saved, it appears in the list on the left panel.

3. Editing an Existing Level

image.png

Click the pencil (Edit) icon to modify its Name, Properties, or Language settings.

If a verification level is already in use by some clients, you cannot delete it—only edit.

3. Defining Statuses for Each Verification Level

1. Statuses Panel (Right Side)

Next to the verification levels, you’ll see a Statuses panel.

image.png

image.png

Each verification level can have its own set of statuses (e.g., Init, Pending, Completed, Rejected).

2. Add or Edit Status

image.png

Click + Add in the Statuses panel to create a new status.

Provide a Label (internal name) and Text (display name).

Save to add it to the list.

image.png

Use the pencil icon to edit an existing status or the trash bin to delete it (if it’s not in use).

4. How Verification Levels and Statuses Appear in Clients

1. Client Type Dependency

If you create a verification level for “Personal,” only Personal clients will see that level.

Similarly, levels for “Business” apply only to Business clients.

2. Edit a Client

image.png

Go to Clients → Edit (pencil icon).

image.png

In the General section, you’ll see Verification level and Verification status dropdowns.

image.pngimage.png

The dropdown options are pulled from the Configurations → Verification Levels you defined.

3. Cannot Delete in-Use Items

If a client is already assigned a certain verification level or status, you cannot remove it from the configuration.

You can rename or update the item, but full deletion is blocked to preserve data integrity.

Key Points to Remember
  1. Client Type Binding: Each verification level is tied to a specific client type (Personal or Business, etc.).
  2. Multiple Statuses per Level: You can define as many statuses as needed to reflect each step (e.g., init, pending, completed).
  3. No Deletion If In Use: Levels or statuses assigned to real clients can’t be removed.
  4. Properties & Language Fields: Allows storing custom data or translations for each level/status, enabling localized or extended flows.

Verification Levels in Configurations enable you to create structured, multi-step KYC (Know Your Customer) processes for each client type. By pairing these levels with custom statuses, you can tailor how a client progresses from “Init” to “Pending” to “Completed,” ensuring each user meets the compliance and verification standards required for their account.


Back to top