小程序在微信使用场景中越来越广泛,腾讯云人脸核身针对小程序提供嵌入式 SDK,开发人员可以将相应的 SDK 添加到小程序开发工具中,从而直接调用小程序 SDK 中提供的 OCR 识别、活体检测和 1:1人脸比对服务。
基于微信小程序原生体验,人脸核身微信小程序接入渠道提供一闪活体检测模式,要求符合以下行业要求且具备相关资质的客户才能申请,接入前请确认公众号的主体和类目是否符合以下范围,并准备好对应的资质文件,资质审核需要5 - 7个工作日,请预留好上线时间。所需对应的资质文件请参见 微信小程序资质文件列表。
政务:机构或事业单位。
金融:银行、保险、信托、基金、证券/期货、持牌消费金融、非金融机构自营小额贷款、汽车金融/金融租赁。
医疗:公立医疗机构、互联网医院、三级私立医疗机构。
运营商:基础电信运营商、虚拟运营商(含转售移动通信)。
教育:学历教育(学校)、公立学校、私立学校。
出行与交通:网约车(快车/出租车/专车/其他网约车)、航空、公交/地铁、水运、骑车、火车/高铁/动车、长途汽车、租车、高速服务。
生活服务:生活缴费。
旅游:酒店。
商业服务:公证。
社交:直播。
物流:收件/派件、货物运输。

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


接入流程


1. 登录 人脸核身控制台,单击自助接入>创建业务流程,完成微信 H5/小程序服务的业务流程创建,获取 RuleID 和小程序 SDK 下载链接。
2. 下载小程序 SDK,并在小程序代码中引入,调用 init 方法进行初始化。
3. 接入方服务端调用实名核身鉴权 DetectAuth 接口,获取到核身流程标识(BizToken)。
4. 客户后端将 BizToken 返回给客户小程序端,然后小程序调用核身方法 startVerify 进入核身流程。
5. 用户完成人脸核身后,会以回调函数形式返回 BizToken ,接入方小程序将 BizToken 传给接入方服务端,接入方服务端即可凭借 BizToken 参数调用获取实名核身结果信息增强版 GetDetectInfoEnhanced 接口去获取本次核身的详细信息,最后将核身结果返回给接入方小程序。
操作步骤
步骤1:创建 RuleId
步骤1:创建 RuleId
RuleId 用于调用配置的业务流程,创建步骤如下:
1. 登录腾讯云人脸核身控制台,在 自助接入 页面,单击创建业务流程。


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


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

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

5. 选择人脸比对库源。人脸核身支持两种方式:跟权威库比对和跟上传照片比对。
其中跟权威库比对的收费价格为:Plus 版人脸核身(权威库)- 微信的价格。
跟上传照片比对的收费价格为:Plus 版人脸核身(自传照片)- 微信的价格。OCR 不再单独收费。


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

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


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


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


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


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

步骤2:获取 BizToken
步骤2:获取 BizToken
完成 RuleId 创建后,需获取 BizToken,用于调用您配置的人脸核身验证的流程。
在线调试
注意:
BizToken 是仅一次核身流程的标识,有效时间为7,200秒;用户完成核身后,开发者可用该标识获取验证结果信息,结果信息仅保留3天。
如果输入参数 RedirectUrl 为空,则用户完成核验后默认跳转腾讯云人脸核身产品介绍页。
步骤3: 回调小程序 SDK
请依据您的技术架构需求,从下文中选取前端 SDK 的接入指引。接入完成后,经回调至小程序端,用户进入核身流程,完成身份证拍摄识别、活体检测等操作完成身份核验。
步骤4: 查询核验结果信息
用户完成人脸核身后,页面会跳转到 wx.startVerify 的回调地址(该回调地址是业务方自定义的绝对路径地址)之后,您在服务端即可凭借 BizToken 参数调用 获取实名核身结果信息 接口去获取本次核身的详细信息。获取到用户验证过程数据,包括文本信息、识别分数、照片和视频。也可以通过访问 腾讯云人脸核身控制台 查看服务调用情况。
说明:
wx.startVerify 的回调地址请参考:该文档 原生开发 SDK 主包接入 章节的第3小节示例中对 success 和 fail 回调的处理方法。
为了保证用户的隐私,结果信息人脸核身侧仅保留3天,请您及时拉取。
在开发、产品使用、费用、合同等问题有任何疑问,欢迎您 联系我们 进行询问。
附录:新版微信开发者工具默认 SWC 编译及关闭方法
升级新版微信开发者工具后,工具默认开启 SWC 编译,可通过
project.config.json 关闭 SWC 编译。在项目根目录
project.config.json 的 setting 节点添加配置:{"setting": {"swc": false,"disableSWC": true}}
修改文件后完全重启微信开发者工具,配置生效。
注意:
若使用微信开发者工具 v2.02 或更高版本,则必须添加此配置,否则设置将不生效。