接入流程说明

最近更新时间:2024-07-03 18:06:31

我的收藏

1. 概述

本接入流程说明旨在指导您如何将E证通微信小程序 SDK 集成到您的应用小程序中。在开始之前,请确保您已经阅读了微信小程序的相关文档并了解了所需的技术背景和配置要求。

2. 准备工作

注册腾讯云账号 (如果您已在腾讯云注册账号,可忽略此步骤)
参考 企业实名认证操作指引 完成账号企业实名认证
开通腾讯云E证通服务,请参见 开通E证通

3. 整体架构图

下图为腾讯云E证通微信小程序的集成架构图:



E证通微信小程序 SDK 集成包括两部分:
A. 服务端集成: 在您的服务端集成腾讯云提供的 API 接口,以获取串联整个流程的 EidToken 和获取E证通核验结果信息。 B. 小程序端集成: 将E证通微信小程序 SDK 集成到您的应用小程序中。

4. 整体交互流程

集成方只需要传入 EidToken 并启动对应的E证通微信小程序 SDK,便可实现包含 OCR 证件识别+活体检测+人脸比对全流程的用户身份认证,待微信小程序用户完成认证流程后,集成方可通过腾讯云 API 接口获取完整的身份认证结果信息。
E证通微信小程序集成相关的服务端 API 接口列表:
获取EidToken的API接口:GetEidToken
拉取E证通身份认证结果API接口:GetEidResult
下图展示了E证通 SDK、小程序端以及服务器端的整体交互逻辑:

E证通小程序接入时序图


具体的详细交互流程如下:

第一步、客户小程序获取 EidToken

1. 接入方小程序初始化E证通小程序 SDK。
2. 初始化完成后,接入方小程序发送请求到接入方服务端获取串联核身流程的 EidToken。
3. 接入方服务端与E证通服务端交互,调用 GetEidToken 接口获取核身需要的 EidToken 并返回,接口调用参考 服务端集成
4. 接入方服务端获取到 EidToken 后保存,并将 EidToken 返回给接入方小程序。

第二步、进入人脸核身流程

1. 接入方小程序拿到 EidToken 后调用 startEid 进入人脸核身流程。
2. E证通小程序 SDK 跳转到 EID 小程序,采集人脸,完成整个核身流程。
3. 核身流程结束后小程序进入回调,返回到接入方小程序。

第三步、接入方小程序使用核身结果

1. 接入方小程序收到回调后发送请求到接入方服务端请求核身结果。
2. 接入方服务端通过调用 GetEidResult 接口拉取核验结果信息并返回。接口调用参考服务端集成
3. 接入方服务端接收到E证通服务端返回的核身结果信息后保存,并告知接入方小程序核身结果。
4. 接入方小程序收到接入方服务端返回的核身结果信息后展示给用户,并进行接下来的业务流程。

5. 接入流程

5.1 申请商户ID

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



2. 完全填写相关信息,然后单击提交等待审核,审核通过后该商户 ID 便可用于获取E证通服务流程唯一标识 EidToken。审核时间从您提交当天开始计算,需要3个工作日,请您预留好时间并耐心等待。
注意:
如果审核后需要您修改资料,审核预估时间会从下次提交时重新计算。




5.2 下载小程序 SDK

审核通过后,可以看到下载小程序 SDK,点击链接下载即可。



5.3 如需要返回身份信息需制作 CSR,具体流程请参考指引

基于对个人隐私信息的保护,按照最小必要返回身份信息的要求,E证通服务不会返回姓名和身份证号的明文信息。如因业务需要返回,可以参考 E证通获取实名信息指引 申请加密返回。

5.4 开始接入

为了能够快速将E证通微信小程序SDK接入到您的小程序应用中,您需要分别完成以下两部分的集成工作:
服务端集成: 请参考 服务端集成完成服务端的集成工作
小程序集成: 请参考 小程序集成 完成E证通小程序SDK的集成工作

6. 联系我们

如您在接入过程中遇到困难,可 联系我们 获取帮助。