如何使用 SumSub
了解如何在 B2CORE 中连接并配置 SumSub 作为 KYC 和 KYT 提供商,包括文档设置、验证级别、流程和 Webhook 设置
本文介绍如何配置 B2CORE 以使用 KYC 和 KYT 提供商 SumSub。
在按照说明继续操作之前,您必须已注册 SumSub 并拥有一个有效账户。对于 KYT 检查,还必须启用并正确配置 SumSub Fraud Prevention。
如何配置与 SumSub 的连接
只有被授予管理外部连接权限的管理员才能设置与 SumSub 的连接。
要设置连接:
在 B2CORE Back Office 中,转到 System > External connections。
点击页面右上角的 +Create。
在 Create connection 页面中,填写以下字段:
- 在 Name 字段中,输入要用于该连接的名称。
- 在 Caption 字段中,输入将在 Back Office 中应用于该连接的标题。
- 在 Provider 下拉列表中,选择 SumSubstance。
点击 Save 以创建连接。
在连接列表中,找到您创建的 SumSub 连接,然后点击 Edit 以输入连接详细信息。
在 Edit connection 页面中,指定以下设置:
- 在 Service Location 字段中,指定
https://api.sumsub.com/。 - 在 Client ID 字段中,指定您的 SumSub 账户名称。要查看账户名称,请在 SumSub 界面中转到 Settings > Account Details。
- 在 Webhook Secret Key 字段中,指定 Webhook 密钥。您应在 SumSub 界面中生成 Webhook。为此,请在 SumSub 界面中转到 Dev space > Webhooks(有关所需的 Webhook 配置,请参阅 SumSub webhook 配置)。
- 将 Login 和 Password 字段留空。
- 在 Token 和 Token Secret 字段中,指定在 SumSub 界面中生成的令牌和密钥值。要生成它们,请在 SumSub 界面中转到 Dev space > App Tokens。
- 若要为 个人 和 企业 客户应用不同的验证流程,请在 Client Resetting Mode 下拉列表中选择 Enabled。
启用 Client Resetting Mode 选项后,类型从 个人 更改为 企业,或反之亦然的客户需要重复进行验证。更改类型后,将发生以下情况:
- 在 B2CORE Back Office 中,客户的验证级别将重置为
Level 0,即默认验证级别。 - 所有待处理的用于获取更高验证级别的客户请求将被自动拒绝。
- 在 SumSub 系统中,申请人将被重置回初始级别,并且此前为该申请人上传的所有文档都会失效。
此前在 B2CORE Back Office 中为该客户上传的所有文件和文档仍然可用。
在 Transaction monitoring 部分中,使用 SumSub Fraud Prevention 配置 KYT 检查设置。目前,这些检查支持法币和加密货币的入金与出金。
-
在 Enabled 下拉列表中,选择:
- Yes — 启用通过 SumSub 进行的交易监控,并在 B2CORE 中接收结果。
- No — 禁用通过 SumSub 进行的交易监控。
-
在 Currency Filter 下拉列表中:
- 选择一种或多种货币,仅监控所选货币的交易。
- 将列表留空,以监控所有货币的交易。
点击 Save 以应用设置。
如何为 SumSub 验证创建文档组
创建文档组以允许客户提交 SumSub 支持的各种文档进行验证。对于希望提供用于验证的每种文档(例如身份证、护照、驾照等),请创建一个具有相应名称的单独文档组。
要创建文档组:
在 B2CORE Back Office 中,转到 Verification > Document groups。
点击页面右上角的 +Create。
在 Create document group 页面中,填写以下字段:
- 在 Name 字段中,指定文档组的名称。
请确保文档组名称与 SumSub 支持的文档类型名称完全一致,例如 ID_CARD、PASSPORT、DRIVERS、RESIDENCE_PERMIT 等。
例如,如果您希望客户提交身份证进行文档验证,请创建一个名称为 ID_CARD 的文档组。
- 在 Caption 字段中,指定将在 B2CORE UI 中显示的文档组标题。
- 在 Type 下拉列表中,选择 One。
- 在 Description 字段中,指定用于 Back Office 的文档组描述。
确保在 Enabled 下拉列表中选择 Yes。
点击 Save 以创建文档组。
如何为 SumSub 验证创建文档类型
对于您创建的每个文档组,请创建一个文档类型。
要创建文档类型:
在 B2CORE Back Office 中,转到 Verification > Document types。
点击页面右上角的 +Create。
在 Create document type 页面中,填写以下字段:
- 在 Name 字段中,指定文档类型的名称。
文档类型名称必须与此前创建的文档组名称相同。例如:ID_CARD、PASSPORT、DRIVERS、RESIDENCE_PERMIT 等。
- 在 Caption 字段中,指定将在 B2CORE UI 中显示的文档类型标题。
- 在 Description 字段中,指定将在 B2CORE UI 中显示的文档类型描述。
- 在 Group 下拉列表中,选择必须与此文档类型关联的文档组。
- 在 Max files 字段中,指定客户可为此文档类型上传的最大文件数量。
在 Status 下拉列表中,选择 Enabled。
点击 Save 以创建文档类型。
如何在 B2CORE Back Office 中为 SumSub 创建验证级别
您可以创建验证级别,或修改现有级别以使用 SumSub 进行验证。
要创建验证级别:
在 B2CORE Back Office 中,转到 Verification > Levels。
点击页面右上角的 +Create。
在 Create verification level 页面中,填写以下字段:
-
在 Index 字段中,指定一个非零整数值。
零(
0)索引始终分配给默认验证级别。对于其他验证级别,索引必须大于零,例如1代表 Level 1,2代表 Level 2,依此类推。 -
在 Wizard 下拉列表中,选择
SnsWizardSDK。 -
在 Caption 字段中,指定将在 B2CORE UI 和移动应用中显示的级别名称,例如
Level 1。如有需要,可点击字段右侧的按钮为该字段指定本地化属性。 -
在 Desktop Description 字段中,指定将在 B2CORE UI 中显示的级别描述。此描述可以包含客户获得该级别后被授予的权限。
B2CORE UI 的描述可以采用 HTML 格式指定。如有需要,可为该字段指定本地化属性。
-
在 Mobile Description 字段中,指定将在移动应用中显示的级别描述。
移动应用的描述可以采用 JSON 格式指定。如有需要,可为该字段指定本地化属性。
-
在 Visible 下拉列表中,选择 Yes。
-
在 Default 下拉列表中,选择 No。(
Level 0始终是默认验证级别。) -
在 Assigned Client Right 下拉列表中,选择一个权限级别,以定义客户获得此验证级别后要授予他们的权限集(有关详细信息,请参阅客户权限)。
-
在 Document groups 下拉列表中,选择一个或多个必需的文档组。例如,如果您希望客户提交身份证和居留许可证进行验证以获得此级别,可以选择
ID_CARD和RESIDENCE_PERMIT。 -
在 Client tests 下拉列表中,如果您希望强制客户在提交文档进行验证前通过这些测试,可选择一个或多个认证测试。可用测试列表包括所有可见性设置为 Yes 的测试,这些测试显示在客户测试页面中。
点击 Save 以创建级别。
如何在 SumSub 界面中创建级别和流程
B2CORE Back Office 支持两种类型的客户:个人 和 企业。SumSub 系统允许为每种类型设置单独的验证流程。要使用此选项,请确保您在配置与 SumSub 的连接时已启用 Client Resetting Mode。
要添加新级别:
在 SumSub 界面中,转到 Integrations > Applicant Levels。
点击 Add new level。
选择所需步骤。
级别名称必须采用以下格式:
- 对于 个人 客户:
level1、level2等。 - 对于 企业 客户:
level3corporate、level4corporate等。
这些格式可确保 SumSub 和 B2CORE 中的级别正确映射。映射基于 B2CORE 中分配给每个验证级别的 Index。您可以在 B2CORE Back Office 的 Verification > Levels 页面相应列中找到索引,并在 SumSub 的级别名称中使用它们。例如:
- SumSub 中的
level1映射到 B2CORE 中 Index = 1 的级别。 - SumSub 中的
level2映射到 B2CORE 中 Index = 2 的级别。 - SumSub 中的
level3corporate映射到 B2CORE 中 Index = 3 的级别。 - SumSub 中的
level4corporate映射到 B2CORE 中 Index = 4 的级别,依此类推。
要添加新流程:
在 SumSub 界面中,转到 Integrations > Verification Flow。
点击 Add new。
选择所需选项。对于每个流程,请选择兼容的级别。
SumSub webhook 配置
已审核
- 名称:
REVIEWED - 接收方:
HTTP Endpoint - 目标:
https://{your-Back-Office-URL}/api/v1/verification-sns/handle - 类型:
Applicant reviewed (applicantReviewed) - 密钥:在 SumSub 中生成的密钥
请务必将 {your-Back-Office-URL} 替换为您的 B2CORE Back Office 域名,而不是 B2CORE UI 的域名。例如,Webhook 的目标可能如下所示:https://example.com/api/v1/verification-sns/handle。
最后更新于