人脸核身 微信小程序接入总指引(微信小程序)

小程序在微信使用场景中越来越广泛,腾讯云人脸核身针对小程序提供嵌入式 SDK,开发人员可以将相应的 SDK 添加到小程序开发工具中,从而直接调用小程序 SDK 中提供的 OCR 识别、活体检测和 1:1人脸比对服务。

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

基于微信小程序原生体验,人脸核身微信小程序接入渠道提供一闪活体检测模式,要求符合以下行业要求且具备相关资质的客户才能申请,接入前请确认公众号的主体和类目是否符合以下范围,并准备好对应的资质文件,资质审核需要3 – 5个工作日,请预留好上线时间。所需对应的资质文件请参见 微信小程序资质文件列表。

·政务:机构或事业单位。

·金融:银行、保险、信托、基金、证券/期货、持牌消费金融、非金融机构自营小额贷款、汽车金融/金融租赁。

·医疗:公立医疗机构、互联网医院、三级私立医疗机构。

·运营商:基础电信运营商、虚拟运营商(含转售移动通信)。

·教育:学历教育(学校)、公立学校、私立学校。

·出行与交通:网约车(快车/出租车/专车/其他网约车)、航空、公交/地铁、水运、骑车、火车/高铁/动车、长途汽车、租车、高速服务。

·生活服务:生活缴费。

·旅游:酒店。

·商业服务:公证、电子认证(新增)。

·社交:直播。

·物流:收件/派件、货物运输。

注意:1、本模式需要先扫码授权:打开二维码 ,小程序管理员扫码后,单击自定义权限,只勾选人脸核身权限,将该权限授权给慧眼第三方平台。(授权成功后将跳转到 腾讯网首页)。

注意:2、如果遇到"你未允许使用xxx权限"的问题,需在正式环境下,登录小程序后台-设置-基本设置-服务内容声明-用户隐私保护指引里面更新一下权限。

一、接入流程

1. 登录 人脸核身控制台,单击自助接入>创建业务流程,完成微信H5/小程序服务的业务流程创建,获取 RuleID 和小程序 SDK 下载链接。

2. 下载小程序 SDK,并在小程序代码中引入,调用 init 方法进行初始化。

3. 接入方服务端调用实名核身鉴权 DetectAuth 接口,获取到核身流程标识(BizToken)。

4. 客户后端将 BizToken 返回给客户小程序端,然后小程序调用核身方法 startVerify 进入核身流程。

5. 用户完成人脸核身后,会以回调函数形式返回 BizToken ,接入方小程序将 BizToken 传给接入方服务端,接入方服务端即可凭借 BizToken 参数调用获取实名核身结果信息增强版 GetDetectInfoEnhanced 接口去获取本次核身的详细信息,最后将核身结果返回给接入方小程序。

二、步骤1:创建 RuleId

RuleId 用于调用配置的业务流程,创建步骤如下:

1. 登录腾讯云人脸核身控制台,在 自助接入 页面,单击创建业务流程。

2. 选择应用场景:微信小程序,并根据需求填写相关信息,填写完成后单击下一步。微信小程序需要上传对应的资质文件,我们会在3 – 5个工作日完成审核。

3. 选择应用类型:选择增强版人脸核身,然后点击下一步。

4. 进入接入配置,根据你业务的实际场景填写页面标题、业务名称、业务描述信息、业务联系方式后单击下一步。

5. 选择人脸比对库源。人脸核身支持两种方式:跟权威库比对和跟上传照片比对。

·其中跟权威库比对的收费价格为:增强版人脸核身(权威库)- 微信的价格。

·跟上传照片比对的收费价格为:增强版人脸核身(自传照片)- 微信的价格。OCR 不再单独收费。

6. 配置身份证 OCR 功能,如果不需要则勾选“不需要用户在验证时上传”,然后单击下一步。

7. 配置活体检测方式,勾选后单击下一步。

8. 配置意愿页面,根据你的业务情况勾选:是否增加用户意愿确认流程,然后单击下一步。请注意,增强版人脸核身默认是不增加意愿确认流程的,如配置了增加意愿确认,则将按意愿核身价格计费,详情请参见 价格说明。

9. 配置结果页的文案描述,然后单击下一步。

10. 业务信息填写完成后,确认你的配置信息和计费信息,然后单击确认并提交审核。

11. 流程审核通过后,系统会自动创建流程并分配业务 ID(RuleId)

三、步骤2:获取 BizToken

完成 RuleId 创建后,需获取 BizToken,用于调用你配置的人脸核身验证的流程。
调用 实名核身鉴权接口,传入 步骤1 生成的 RuleId,和认证结束后重定向的回调链接地址 RedirectUrl,得到核验流程唯一密钥(BizToken)和用于发起核身流程的 URL。

·在线调试

注意:BizToken 是仅一次核身流程的标识,有效时间为7,200秒;用户完成核身后,开发者可用该标识获取验证结果信息,结果信息仅保留3天。
如果输入参数 RedirectUrl 为空,则用户完成核验后默认跳转腾讯云人脸核身产品介绍页。

四、步骤3: 回调小程序 SDK

请依据你的技术架构需求,从下文中选取前端 SDK 的接入指引。接入完成后,经回调至小程序端,用户进入核身流程,完成身份证拍摄识别、活体检测等操作完成身份核验。

·微信小程序原生接入流程

·微信小程序 uni-app 接入流程

·微信小程序 Taro 接入流程

五、步骤4: 查询核验结果信息

用户完成人脸核身后,页面会跳转到 wx.startVerify 的回调地址(该回调地址是业务方自定义的绝对路径地址)之后,你在服务端即可凭借 BizToken 参数调用 获取实名核身结果信息 接口去获取本次核身的详细信息。获取到用户验证过程数据,包括文本信息、识别分数、照片和视频。也可以通过访问 腾讯云人脸核身控制台 查看服务调用情况。

注意:说明:

六、附录:新版微信开发者工具默认 SWC 编译及关闭方法

升级新版微信开发者工具后,工具默认开启 SWC 编译,可通过 project.config.json 关闭 SWC 编译。

在项目根目录 project.config.json 的 setting 节点添加配置:

{ "setting": { "swc": false, "disableSWC": true }}

修改文件后完全重启微信开发者工具,配置生效。

注意:若使用微信开发者工具 v2.02 或更高版本,则必须添加此配置,否则设置将不生效。

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