How to use ShuftiPro
Last updated
Was this helpful?
Last updated
Was this helpful?
This article provides instructions on how to configure B2CORE to use the KYC provider, . With ShuftiPro, you can conduct document and face verification to validate the identity of individual clients, as well as address and location verification.
In addition to document verification, you can enable the SuftiPro Anti-money laundering (AML) check to screen your clients against multiple AML data sources, helping to protect your company from potential money laundering activities.
Only admins who are assigned the permissions to manage external connections can set up a connection to ShuftiPro.
To set up a connection:
In the B2CORE Back Office, navigate to System > External Connections.
Click +Create in the upper-right page corner.
On the Create connection page, fill in the following fields:
In the Name field, specify a name that you want to use for the connection.
In the Caption field, specify a caption that will be applied to the connection in the Back Office.
In the Provider dropdown, select ShuftiPro.
Click Save to create the connection.
In the connections list, find the ShuftiPro connection that you've created and click Edit to enter the connection details.
On the Edit connection page, specify the following settings:
In the API host field, specify https://api.shuftipro.com.
In the Client ID and Secret key fields, specify the client ID and secret key value to access ShuftiPro.
In the New signature (for secrets after March 2023) field, select either:
No — for clients who registered with ShuftiPro before March 15, 2023.
Yes — for clients who registered with ShuftiPro or updated their secret keys after March 15, 2023. This is needed to validate a key signature returned in ShuftiPro API responses (for details, refer to in the ShuftiPro documentation).
In the Allow documents screenshots dropdown, select Enabled to allow clients to upload document screenshots for verification, instead of requiring only live captures.
By default, this option is disabled.
In the Check AML dropdown, select Enabled to use the SuftiPro Anti-money laundering (AML) check. In this case, when clients submit documents for upgrading their verification levels they will be additionally screened against SuftiPro AML data sources, including multiple global watchlists, FATF lists, PEP lists, and Sanction lists, to prevent the risk of money laundering.
By default, this option is disabled.
When the AML check is enabled, a client must meet two conditions to obtain a higher verification level: the submitted documents must be verified, and the AML check must be successful. If either condition fails, the verification level upgrade will be rejected.
In the Enabled dropdown, select Yes.
Click Save to apply the settings.
For document verification, create three document groups with the names passport, id_card, and driving_license. These groups enables you to request your clients to submit various documents, such as passports, national identity cards, and driving licenses, for identity verification.
For address and location verification, create four document groups with the names rent_agreement, bank_letter_receipt, employer_letter, and utility_bill. These groups enables you to request your clients to submit various documents, including rent agreements, bank letter receipts, employer letters, and utility bills to confirm their addresses and locations such as cities or countries.
For face verification, create a document group with the name selfie.
To create a document group:
In the B2CORE Back Office, navigate to Verification > Document groups.
Click +Create in the upper-right page corner.
On the Create document group page, fill in the following fields:
In the Name field, specify the name of a document group.
In the Caption field, specify a document group caption that will be displayed in the B2CORE UI.
In the Type dropdown, select One.
In the Description field, specify a description for the document group that is used in the Back Office.
Make sure that Yes is selected in the Enabled dropdown.
Click Save to create the document group.
For each document group that you've created, create a document type.
To create a document type:
In the B2CORE Back Office, navigate to Verification > Document types.
Click +Create in the upper-right page corner.
On the Create document type page, fill in the following fields:
In the Name field, specify the name of a document type.
In the Caption field, specify a document type caption that will be displayed in the B2CORE UI.
In the Description field, specify a description for the document type that will be displayed in the B2CORE UI.
In the Group dropdown, select a previously created document group with which this document type must be associated.
In the Max files field, specify the maximum number of files that clients can upload for this document type.
In the Status dropdown, select Enabled.
Click Save to create the document type.
You can create verification levels or modify the existing levels to use ShuftiPro for document, address, and face verification.
To create a verification level:
In the B2CORE Back Office, navigate to Verification > Levels.
Click +Create in the upper-right page corner.
On the Create verification level page, fill in the following fields:
In the Index field, specify a non-zero integer value.
The zero (0) index is always assigned to the default verification level. For other verification levels, the index must be greater than zero, such as 1 for Level 1, 2 for Level 2 and so on.
In the Wizard dropdown, select ShuftiProSDK.
The ShuftiPro popup will open in the B2CORE UI, enabling clients to follow the verification instructions and submit the required documents.
In the Caption field, specify a level name that will be displayed in the B2CORE UI and mobile app, such as Level 1. If required, specify the localization properties for this field by clicking the button located on the right side of the field.
In the Desktop Description field, specify a description of the level to be displayed in the B2CORE UI. This description can include the permissions granted to clients once they obtain this level.
The description for the B2CORE UI can be specified in the HTML format. If required, specify the localization properties for this field.
In the Mobile Description field, specify a level description to be displayed in the mobile app.
The description for the mobile app can be specified in the JSON format. If required, specify the localization properties for this field.
In the Visible dropdown, select Yes.
In the Default dropdown, select No. (Level 0 is always the default verification level).
In the Document groups dropdown, select one or more required document groups. For example, you can select passport and selfie if you want your clients to submit their passports and pass face verification to receive this level.
Click Save to create the level.
In the Assigned Client Right dropdown, select a permission level defining the set of permissions that you want to grant to your clients after obtaining this verification level (for details, refer to ).
In the Client tests dropdown, optionally select one or more accreditation tests if you want to force your clients to pass these tests before they can submit their documents for verification. The list of available tests includes all the tests with visibility set to Yes, which are displayed on the page.