H5(移动端浏览器)

最近更新时间:2024-10-11 15:23:41

我的收藏
本文为您描述如何接入E证通 H5,接入相关指引链接如下:
详细接入操作如下:

申请商户 ID

1. 登录腾讯云慧眼 人脸核身控制台,单击自助接入>E证通服务>申请商户 ID。


2. 完全填写相关信息,然后单击提交。审核时间从您提交当天开始计算,需要3个工作日,请您预留好时间并耐心等待。
注意
如果审核后需要您修改资料,审核预估时间会从下次提交时重新计算。



3. 审核通过后,可以在自助接入列表页,查看商户 ID,后续需要使用商户 ID 获取E证通服务流程唯一标识 EidToken。

获取 EidToken 和 URL

接入方服务端调用 获取E证通 Token 接口,传入E证通服务所需信息获取到 EidToken 以及核身 URL。该 URL 有效为十分钟,且仅能使用一次。

跳转至 H5 进行核身

用户跳转至第二步获取到的 URL 完成核身之后,接入方可以有两种方式获取核身结果事件:接入方后台轮询、E证通重定向。

接入方后台轮询方式

如果接入方业务全程都在 PC 端的网页进行,可以将第二步获取到的核身 URL 转换为二维码进行展示,提示用户使用手机微信扫码进入E证通业务流程。接入方通过后台轮询 CheckEidTokenStatus 接口的方式实时检查用户的验证状态,然后根据返回的状态合理设计业务流程。
注意
建议轮询间隔为1秒。遇到网络错误等异常状态连续三次以上才认为失败,否则均保持上一次状态。

重定向方式

如果接入方有自己的 H5,需要在第二步获取 EidToken 传入 RedirectUrl,在用户核身完成之后,Eid 会在微信 H5 中重定向到 RedirectUrl 并在 query 参数携带 token={EidToken}。接入方 H5 接收到参数后可以进行后续流程。
注意
建议接入方重定向地址为后端接口,并在 URL 中有自身的鉴权信息,核身结果根据 EidToken 从腾讯云后台拉取。

获取 E证通核验结果信息

接入方获取到完成事件后,调用 获取 Eid 核身结果信息 接口去获取本次核身的详细信息。

接入时序图(轮询)

注意
轮询应从获取 EidToken 之后就开始,对 EidToken 状态相应处理,如果核身完成就可以拉取核身结果。




接入时序图(重定向)




说明:
基于对个人隐私信息的保护,按照最小必要返回身份信息的要求,E证通服务不再返回姓名和身份证号的明文信息。如因业务需要返回,请查看E证通获取实名信息指引