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

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

无线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前端开发参考
  • 服务端获取认证URL地址

    发起认证请求(DescribeVerifyToken)获取接入方H5认证流程页面入口的URL地址。

  • 打开页面的方式
    • 微信公众号中使用:直接打开认证URL地址。
    • 小程序中使用:使用web-view组件打开。
  • URL回调方案

    适用于希望在认证结束后,回调跳转至自己开发页面的场景。

    • 如希望在认证通过后跳转到指定URL,可在认证URL后加上successRedirect参数。
    • 如希望在认证不通过后跳转到指定URL,可在认证URL后加上failRedirect参数。
    • 如果不传入,则会跳转到实人认证默认的认证结果页。
    说明 回调地址参数需要通过encodeURIComponent进行编码。
  • 回调至自己的H5页面
    // 以下是JavaScript示例代码
    
        const successRedirect = 'https://www.your_h5_sucess_address';
    
        const failRedirect = 'https://www.your_h5_fail_address';
    
        const originUrl = 'H5认证流程页面入口 URL,从发起认证请求(DescribeVerifyToken)获得'; 
    
    
    // 最终拼接结果(重要)
    
        const resultUrl = `${originUrl}&successRedirect=${encodeURIComponent(successRedirect)}&failRedirect=${encodeURIComponent(failRedirect)}`;
    
    
    // 最终结果示例
    
        resultUrl === H5认证流程页面入口URL&successRedirect=https%3A%2F%2Fwww.your_h5_sucess_address&failRedirect=https%3A%2F%2Fwww.your_h5_fail_address
  • 回调至小程序页面

    回调至小程序页面可采用相同的方式传入参数,唯一的不同是需要使用小程序页面的绝对路径,地址示例如下:const successRedirect = '/pages/index/index';

服务端接入

纯服务端接入



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

适用的认证方案:RPMin

服务端接入