功能简介

Sumsub帮助平台提供KYC自动审核的解决方案。

配置要点:

1、请确保Sumsub所有的参数配置与申请是在生产环境,不要使用测试环境申请

       绿色代表生产环境,黄色代表沙盒(测试)环境


2、Webhook配置很重要,不配置,交易所获取不到用户的 认证状态。

webhoot配置内容如下:https://appapi.xxx.com/exchange-app-api/sumsub/noToken/get_webhook_info

其中 https://appapi.xxxx.com 中的“xxxx.com” 为您平台的域名。


3、Sumsub的level name 不能包含空格,请注意(错误格式 “level 1”,正确格式:“level1”、“level-1”、“level_1”)。


功能开通

首先开通功能需要事先联系销售或大客户支持--运营。运营给分配Sumsub的功能菜单及操作权限。

STEP 1: 后台点击开通功能(用户管理–认证等级—开通Sumsub)

开通后将多出几个配置的功能按钮,如下图:

注意:创建等级后,用户账号使用该等级进行实名认证,等级就无法删除,通过认证的用户账号也无法驳回。因此,在创建等级时,请慎重创建正式使用的等级。


STEP 2: 配置接入参数

Setting:主要配置Sumsub的接入参数,页面如下:

a、参数的获取来源于Sumsub的后台页面

请确保Sumsub所有的参数配置与申请是在生产环境,不要使用测试环境申请

绿色代表生产环境,黄色代表沙盒(测试)环境

创建App Tokenshttps://cockpit.sumsub.com/checkus#/devSpace/appTokens


b、点Create a new App Token”按钮,进入创建页面:

在此,你可以定义一个应用的名称,和白名单地址(配置后只有白名单才可以访问对应接口,不配置,就不限制)。所有的权限选择可以保持默认,不要更改。


c、 然后,点击“Create a new App Token”后,你的APP key 和秘钥即将生成完成。页面如下:

切记,需要拷贝Token 以及Secret Key。点击“All is saved”后,Secret Key不可再次查看。


d、 点击保存后,将在申请列表中查看申请的记录,页面样式如下:


3、Add Level: 定义等级(目前只支持一个等级)。页面样式如下


功能介绍:

  1. 定义当前等级的对应提币的额度,折算成USDT。(24小时累计,UTC+8- 00:00~23:59)

  2. 要求:请保持与Sumsub一致(不一致,实际认证按Sumsub中定义的为准)

  3. 排序:默认level1 为1、level2 为2.。请按照正确顺序对应,影响前端的显示。

  4. SDK Setting :该功能参数均来源于Sumsub。

  5. Level Name :请保持与Sumsub的定义的levelName一致(第三方页面: https://cockpit.sumsub.com/checkus#/devSpace/appTokens


6. Flow Name,来源于Sumsub,移动端与pc端需要单独配置对应的额Flow。页面如下:(第三方页面:https://cockpit.sumsub.com/checkus#/sdkIntegrations/customizations

每个level需要对应两个Flow。


7. 创建Flow。Flow中需要区分Mobile 和web ,并且需要确定当前Flow对应的认证等级。其他参数可以自行配置。点击"",开始配置,页面如下:


8. 创建完成Flow后,需要在对应的等级页面关联对应的Flow name。


9. 编辑页面如下方:

之后点击点击保存。


STEP 4: 将第三方平台定义的名称再次粘贴到商户后台进行保存,保存后,当前等级就会生效。页面如下:


STEP 5: 添加完成后,列表中奖显示当前的等级和相关的配置信息。



  1. 当用户使用交易所系统实名认证通过后,商户开启Sumsub功能时,用户不会再次进入sumsub认证。若需要用户重新认证,请将用户在交易所的认证审核给拒绝。未认证的用户,在sumsub开启后,使用Sumsub认证(交易所认证将被影藏)

  2. 当你没有申请sumsub平台的功能时,请不要在后台开通Sumsub认证(前端认证将出错)

  3. 当开启Sumsub功能后,再次关闭,所有用户在Sumsub认证状态,系统将不保留,需要重新在交易所进行认证。(再次开启后,将同步原有的状态)


配置webhook。配置内容如下:https://appapi.xxx.com/exchange-app-api/sumsub/noToken/get_webhook_info

其中 https://appapi.xxxx.com 中的“xxxx.com” 为您平台的域名。

配置入口(https://cockpit.sumsub.com/checkus#/devSpace/webhooks

如果不填写,将获取不到Sumsub的认证状态。


Name可以随便写,但是Applicant type 选择“Person”,types需要选择“applicant Created” “Applicant Received


Sumsub认证信息

在如下页面,您可以看到用户的申请认证记录以及状态。审核状态全由Sumsub平台审核,交易所后台不提供Sumsub的认证审核功能。














  • 无标签