With client lists, you can manage flexible sets of values to create verification flows and transaction monitoring rules, blocklist or whitelist applicants, manage workflows in Workflow builder, and many other.

How it works

Lists can be categorized based on their purpose and type:

• Lists by purpose
  • Custom lists — multipurpose lists for exclusive or duplicate profiles.
  • Blocklists — for applicants to be blocked within your project.
  • Whitelists — for applicants that cannot be blocklisted within your project.
• Lists by type
  • Value. Refers to the trigger configured in the applicant workflow, such as the country, age, or previous verification results. Applicants with defined values will be processed in accordance with the list type. Mind that value-based list types are only available if the applicant flow is enabled and configured.
  • Applicant IDs. Include 22 character alphanumeric Sumsub applicant IDs.
  • Emails. Include email addresses.
  • Fingerprints. Include unique blockchain identifiers or device distinctive marks.

The purpose and key type you select will be used to create a unique identifier for the list.

Each time you create a transaction monitoring rule or verification flow, you can use items from client lists as triggers for auto-decline, switching between verification levels, delegation, and many other.

Default lists

Sumsub offers the following ready-made empty lists that allow you to either block or allow certain actions:

• Dangerous BTC wallets. A Bitcoin wallet address is a combination of letters and numbers used to perform Bitcoin transactions.
• Dangerous currencies. Money launderers often use crypto currencies to buy Credit, Virtual Chips, or In-Game Currency and cash it after a couple of transactions. So you can create a rule that would put transactions involving assets from your list on hold and assign a human expert to review these.
• Risky payment details. Some payment methods are more vulnerable in terms of fraud than the other. Creating a list of the ones you want double-checked will help you reduce chargeback while keeping the friction low.

Custom lists

You can create your own lists that contain items of a specific type of information. The types of lists that you can create (but not limited to) are:

• Lists of custom values — string-based or value-based lists that can contain IP Addresses, case-sensitive strings, Card BINs, countries, etc.
• Applicant ID lists that include 24 character alphanumeric Sumsub applicant IDs.
• Emails lists that include email addresses.
• Device fingerprints lists that include unique blockchain identifiers.

These lists can be used to automatically reject any activities for a specific group of applicants (blocklists), to create groups of applicants that cannot be blocklisted (whitelists), or for any other purpose you can think of (custom).

To create a list:

1. In the Dashboard, go to the Client lists page.
2. Click Create list and provide a list title and optional description.
3. Select a key type to be used as a trigger and choose a list type.
4. Click Create.
5. Populate your list by entering a reference value, depending on the list type. For example, an applicant ID, email address, and so on.

Manage lists

You can manage lists as follows:

• Import lists. Lets you import an existing list from a CSV file.
• Edit list description. Lets you adjust your existing list description.
• Remove any list that you have configured previously. Lets you declutter your environment by removing lists that are no longer in use.