本章节内容适用于实人认证产品的接入时序参考,以下针对三种不同的接入方式进行详细说明。

单击查看老版本接入文档说明。

无线SDK+服务端接入



时序图说明
  • Step1:接入方在移动APP中集成接入了无线认证SDK,并进行SDK初始化。
  • Step2:用户进入接入方APP的认证业务入口,准备开始认证。
  • Step3~Step5:接入方服务端调用发起认证请求接口,从实人认证服务端获取token,同时,根据不同的认证方案,可以通过该接口提前传入一些材料。取到token后返回给接入方APP端。
  • Step6:接入方APP调起认证SDK,用户进入认证操作流程,根据不同的认证方案,需要用户做不同的操作比如做动作活体、拍摄身份证正反面等。
  • Step7:用户操作完成后,由无线SDK将本次用户操作提交到实人认证服务端。
  • Step8:实人认证服务端根据综合决策逻辑,进行认证结果判定。
  • Step9~Step10:实人认证服务端将认证结果回调给无线SDK,并由无线SDK将结果回调告知接入方APP。
  • Step11~Step13:接入方APP接收到认证结果回调后,此时接入方服务端就可以调用获取认证状态的接口,从实人认证服务端来获取认证状态和认证资料。(客户端回调的认证状态存在一定可能性会被恶意篡改,建议由接入方服务端调接口来实人认证服务端获取最终可信的状态,并据此做业务上的决策)。

适用的认证方案:RPBasicRPManualRPBioIDRPBioOnlyProRPBioOnly

服务端接入

移动H5+服务端接入



时序图说明
  • Step1:用户进入接入方移动H5的认证业务入口,准备开始认证。
  • Step2~Step4:接入方服务端调用发起认证请求接口,从实人认证服务端获取token,同时,通过该接口提前传入姓名、身份证号、身份证正反面(可选)。实人认证服务端会返回一个认证跳转url,该url中包含了token。
  • Step5:接入方移动H5跳转到该认证url地址,进入到实人认证H5认证页面,用户开始操作,录制视频。
  • Step6:用户操作完成后,由实人认证H5将本次用户操作提交到实人认证服务端。
  • Step7:实人认证服务端根据综合决策逻辑,进行认证结果判定。
  • Step8~Step9:实人认证服务端将认证结果回调给实人认证移动H5,并跳转重定向到接入方指定的H5地址。
  • Step10~Step12:跳转重定向到H5地址后,此时接入方服务端就可以调用获取认证状态的接口,从实人认证服务端来获取认证状态和认证资料。(移动H5端回调的认证状态存在一定可能性会被恶意篡改,建议由接入方服务端调接口来实人认证服务端获取最终可信的状态,并据此做业务上的决策)。

适用的认证方案:RPH5BioOnly

H5 前端开发参考
  • 接入方H5认证流程页面入口 URL,从发起认证请求(DescribeVerifyToken)获得。
  • 认证结果重定向链接
    • 认证通过跳转指定 URL,可在认证 URL 后加上 successRedirect 参数:{认证流程页面入口URL}&successRedirect={认证通过时重定向URL}
    • 认证不通过跳转指定 URL,可在认证 URL 后加上 failRedirect 参数:{认证流程页面入口URL}&failRedirect={认证不通过时重定向URL}
说明 重定向 URL 需要加上协议头,并先使用 encodeURIComponent 编码后再拼接。
服务端接入

纯服务端接入



时序图说明
  • Step1:由接入方服务端发起认证请求,提交姓名、身份证号、人像照、身份证正反面(可选)等材料。
  • Step2~Step3:实人认证服务端根据综合决策逻辑,进行认证结果判定。并同步返回认证状态和资料。

适用的认证方案:RPMin

服务端接入