如何使用 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。

最后更新于

本页目录