人脸核身 H5(微信浏览器)(E 证通)

这篇说说E证通H5接入流程,包括申请商户ID、获取EidToken和URL、跳转核身及获取结果,支持轮询与重定向两种方式。 申请商户ID:登录控制台填写信息,审核需3个工作日。 获取EidToken:调用接口获取Token及URL,有效期10分钟且仅用一次。 核身与结果:用户完成核身后,通过轮询或重定向获取结果,再调用接口获取详细信息。

相关产品
人脸核身 产品页,含版本规格、价格与购买入口。

这篇为你描述如何接入 E 证通 H5,接入相关指引链接如下:

1. 开通E证通

2. 申请商户 ID

3. 获取 EidToken

4. 跳转至 H5 进行核身

5. 获取 E 证通核验结果信息

6. 查看错误码

详细接入操作如下:

一、申请商户 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 证通获取实名信息指引。

赞 (0)
上一篇 4天前
下一篇 4天前