基于微信小程序原生体验,人脸核身微信小程序接入渠道提供一闪活体检测模式,要求符合以下行业要求且具备相关资质的客户才能申请,接入前请确认公众号的主体和类目是否符合以下范围,并准备好对应的资质文件,资质审核需要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. 选择应用类型:选择 Plus 版人脸核身,然后单击下一步。
4. 进入接入配置,根据你业务的实际场景填写页面标题、业务名称、业务描述信息、业务联系方式后单击下一步。
5. 选择人脸比对库源。人脸核身支持两种方式:跟权威库比对和跟上传照片比对。
·其中跟权威库比对的收费价格为:Plus 版人脸核身(权威库)- 微信的价格。
·跟上传照片比对的收费价格为:Plus 版人脸核身(自传照片)- 微信的价格。OCR 不再单独收费。
6. 配置身份证 OCR 功能,如果不需要则勾选“不需要用户在验证时上传”,然后单击下一步。
7. 配置活体检测方式,勾选后单击下一步。
8. 配置意愿页面,根据你的业务情况勾选:是否增加用户意愿确认流程,然后单击下一步。请注意,Plus 版人脸核身默认是不增加意愿确认流程的,如配置了增加意愿确认,则将按意愿核身价格计费,详情请参见 价格说明。
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 或更高版本,则必须添加此配置,否则设置将不生效。