Skip to main content
Skip table of contents



Tier is a subtype that can be applied to clients for an extra charge to deliver a higher verification level for banking services.

The functionality operates as follows:

  1. A new Tier level is created in the Dictionaries section. The Tier level defines a client subtype that will be used for further configuration.

  2. A new Limit is created for the corresponding client subtype.

  3. Once a Tier is created it becomes available for selection in the Web Interface.

  4. The client selects a Tier level from the list of suggested options and pays the transition fee. Further recurring payments will be charged according to the client’s price list.

  5. The Tier label and a corresponding client subtype are assigned to the client’s profile in the Admin panel.

  6. The new set of limits is assigned to the client. Further transactions will be processed according to the new rules.

  7. The client can change their Tier level to another one from the Web Interface. Once the transition fee is charged, their limits will be updated according to the new subtype.

Related pages


How to add a new Tier level

The process of configuring a Tier level consists of the following steps:

  1. Creating a Tier level in the Dictionaries section.

  2. Creating a limit for the Tier level.

  3. Adding a Changing verification level fee to the existing price lists.

  4. Assign a limit to the Tier level.

To create a new Tier level

  1. Navigate to the Dictionary menu item.

  2. The list of active dictionaries will be opened.

  3. Click Add New in the top-right corner of the tab.

  4. Set the Type parameter to Verification level. The dictionary type is used to set custom verification level names that can be selected by clients for upgrade/downgrade.

  5. Customize default labels. The verification level dictionary is labeled per level. If levels are not labeled, default names will be used. API values for each label will correspond to the default Level 1-5 values.

  6. Click Create to save the new Dictionary. The labels will be available in client profiles.

Create a dictionary

How to create a Limit

To create a Limit

  1. Navigate to the Limits tab.

  2. Click Add New in the top-right corner.

  3. Select a Client Verification Level to set the limit for, see Identification requests for details. The parameter can also be used to define a Tier level for the limit.

  4. Select a Client Type.

  5. Select a Person type or Company type depending on the client type selected in the previous step. The field is optional and can be used to narrow down the list of clients the limit should be applied to At least one dictionary must be configured. See Dictionary for details.

  6. Type in the limit name in the Name field.

  7. Add a description in the Description field.

  8. The limit status is Active by default. Disable the limit if you do not need it active once it is created.

  9. Click Add New to add a threshold for transactions or transfers.

  10. Fill in the Thresholds details (See the Configuring the component section for parameters required for threshold configuration).

  11. Click Create to confirm the limit initiation.

Assignment priorities

The created limit is assigned to clients automatically according to the following priority parameters from highest to lowest:

  1. Client type: Person or Company.

  2. Client subtype: Tier levels defined in Dictionaries.

  3. Client verification level.

The verification level correlates with the client identification stage:

  • Level 0 (not verified)

  • Level 1 (email and phone number verified)

  • Level 2 ( email, phone number, and documents verified by Sumsub service provider)

  • Level 3 (the level is set manually if an additional verification level is required. For example, address verification)

  • Level 4 (the level is set manually if an additional verification level is required. For example, proof of funds)

  • Level 5 (custom requirements that can be used to extend the limits provided, the functionality can be enabled in the system configs).

  • Transactions are restricted for Level 0 and Level 1. Such transactions remain on hold until the user goes through the KYC process.

  • If there is no limit defined for a verification level, the system will consider the limit of a lower level as active. For example, if a limit configuration is missing for the Verification Level 2, the limit of the Verification Level 1 will be applied by default.

  • If a limit is crossed by a personal threshold, the one with lower values will be considered for a corresponding profile.

How to create a fee for changing verification levels

The Change verification level fee tab, available in the top sidebar of a price list, allows to browse and add new rules to the price list such as the following:

  • Fees for upgrading a verification level

  • Fees for downgrading a verification level

The functionality is implemented to charge clients when they switch their Tier level via the Web Interface, including upgrades to a custom verification level with extended limits.

To create a fee for changing verification levels

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of price lists will be opened.

  3. Select a price list with a Person/Company type option selected and click Edit.

  4. The price list details window will be opened.

  5. Navigate to Change verification level fees in the top sidebar.

  6. Click Add New in the top-right corner.

  7. The Price list field value will be automatically filled with the current price list name. If necessary, change a price list for the rule:

    1. Click List next to the price List field.

    2. Select a price list from the arisen menu.

  8. Fill in the Details form. Fields with an asterisk (*) are mandatory.

    1. Set a fee name in the Name field. The name should be identical to the Tier level name set in its Label field. See Tiers for details.

    2. Optionally, set the Label field to define the name of the fee in Web and Mobile Interfaces.

    3. Click the Operation type field to define whether the fee rule should be applied to upgrades or downgrades.

    4. Select the target verification level from the Verification level drop-down menu. The fee will be charged when switching to the selected level.

    5. Set the Valid from and Valid to parameters to define the rule validity period.

  9. Fill in the Amounts form. Fields with an asterisk (*) are mandatory.

    1. Set the Currency field to define the fee currency. It is recommended to select the default currency allowed by the service provider

    2. Set the Fixed fee to define the fixed rate. The fixed amount will be charged once the selected verification level is upgraded (or downgraded).

  10. Click Create to save the rule parameters. The rule will be added to the price list. Create more fee rules with different verification levels and operation types.


How to assign a limit

Tier limits are automatically assigned to subscribed users if the following conditions are met:

  • Each Tier level is provided with a limit.

  • Client profiles are provided with a Tier label. The label is set automatically once the client upgrades/downgrades their Tier level.

  • The Client subtype parameter is set for every related limit.

  • The Change verification level fee is configured.

There must be no personal limits configured in client profiles. Personal limits are of higher priority and cannot be ignored. It is recommended to avoid personal configuration when working with Tiers.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.