本文为您描述如何接入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
跳转至 H5 进行核身
用户跳转至第二步获取到的 URL 完成核身之后,接入方可以有两种方式获取核身结果事件:接入方后台轮询、E证通重定向。
接入方后台轮询方式
如果接入方业务全程都在 PC 端的网页进行,可以将第二步获取到的核身 URL 转换为二维码进行展示,提示用户使用手机微信扫码进入E证通业务流程。接入方通过后台轮询 CheckEidTokenStatus 接口的方式实时检查用户的验证状态,然后根据返回的状态合理设计业务流程。
注意
建议轮询间隔为1秒。遇到网络错误等异常状态连续三次以上才认为失败,否则均保持上一次状态。
重定向方式
如果接入方有自己的 H5,需要在第二步获取 EidToken 传入
RedirectUrl
,在用户核身完成之后,Eid 会在微信 H5 中重定向到 RedirectUrl 并在 query 参数携带 token={EidToken}
。接入方 H5 接收到参数后可以进行后续流程。 注意
建议接入方重定向地址为后端接口,并在 URL 中有自身的鉴权信息,核身结果根据 EidToken 从腾讯云后台拉取。
获取 E证通核验结果信息
接入时序图(轮询)
注意
轮询应从获取 EidToken 之后就开始,对 EidToken 状态相应处理,如果核身完成就可以拉取核身结果。
接入时序图(重定向)
说明: