人脸核身
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 人脸核身 > 含 UI 集成方案 > 意愿核身 > 微信小程序 > 意愿核身小程序接入流程

意愿核身小程序接入流程

最近更新时间：2024-04-11 15:24:41

我的收藏

本页目录：

1. 前提条件

1.已注册腾讯云账号，并完成企业实名认证。
2.已申请开通腾讯云人脸核身服务。
如果还未完成以上操作，可参考 流程指引 完成操作。

2. 接入时序图





3. 接入流程

下面将为您描述如何接入意愿核身小程序，详细接入操作如下：

步骤1：接入前准备

确认小程序类目、配置授权以及域名白名单，详情请参见 接入准备。

步骤2：创建 RuleID

RuleId 用于调用配置的业务流程，创建步骤如下：
1. 登录人脸核身控制台，在 自主接入 页面，单击创建业务流程。


2. 选择应用场景：选择微信小程序并填写相关信息。


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


4. 选择人脸比对库源。人脸核身支持两种方式：跟权威库比对和跟上传照片比对，其中跟权威库比对收费价格为意愿核身（权威库）的价格，跟上传照片比对收费的价格为意愿核身（自传照片）的价格，详细价格请见 价格说明。


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


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


7. 配置意愿确认时请勾选是，增加意愿确认，勾选后单击下一步。配置后产品将按意愿核身价格计费，详情请参见 价格说明。


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


9. 业务信息填写完成后，确认您的配置信息然后单击确认并提交审核。



步骤2：获取 BizToken

下载 意愿核身小程序 SDK，并在小程序代码中引入，调用 init 方法进行初始化。
接入方服务端调用实名核身鉴权 DetectAuth 接口，传入意愿核身所需配置参数，获取到核身流程标识（BizToken）。
可在Config参数中选择的所需意愿核身类型（问答模式/点头确认模式），使用 IntentionQuestions.N 或 IntentionActions.N 传入问答模式或点头确认模式的语音播报内容。
建议开启 Config 中的 IntentionRecognition（意图识别）开关，可提升语音识别通过率。

步骤3：跳转人脸核身 URL 完成核验

接入方服务端将 BizToken 返回给接入方小程序，然后小程序调用核身方法 startVerify 进入核身流程。

步骤4：查询核验结果信息

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

4. SDK 接入

4.1 开发准备

下载 SDK 下载 意愿核身小程序 SDK，并在小程序代码中引入，调用 init 方法进行初始化。
安装 SDK 将小程序 SDK 文件夹放在小程序根目录下，使用 require 函数引入。 const Verify = require('/verify_mpsdk/main');
卸载 SDK 卸载时删除 verify_mpsdk 文件夹，移除相应 require 代码即可。
调试 SDK 微信开发者工具中使用预览模式调试。

4.2 快速入门

1. 将 verify_mpsdk 文件夹放到小程序项目根目录。
2. 初始化意愿核身 SDK。 在 App.js 的 onLaunch() 中加入相应代码，在 App.json 文件里添加意愿核身页面 verify_mpsdk/index/index 。
//app.js
App({
    onLaunch: function () {
        // 初始化意愿核身组件
        const Verify = require('/verify_mpsdk/main');
        Verify.init();
    }
}) 
// app.json
{
    "pages":[
        "verify_mpsdk/index/index"
    ]
}
3. 调用 SDK 功能函数 wx.startVerify()。 在需要意愿核身的地方调用 wx.startVerify() 进入意愿核身页面，认证完成会触发对应的回调函数。
// 单击某个按钮时，触发该函数
gotoVerify: function () {
    // 去接入方服务端调用DetectAuth接口获取BizToken，需要接入方服务端自行实现
    let BizToken = getBizToken();
    // 调用实名核身功能
    wx.startVerify({
        data: {
            token: BizToken // BizToken
        },
        success: (res) => { // 验证成功后触发
            // res 包含验证成功的token
        },
        fail: (err) => {  // 验证失败时触发
            // err 包含错误码，错误信息
        }
    });
}

4.3 基本 API 描述

Verify.init(options) ：初始化插件。
options ：Object required 初始化的参数。
wx.startVerify(options) ：进入意愿核身页面。
options ：Object required 初始化的参数。
options.data.token ：String required 客户后端调用 DetectAuth 接口获取的 BizToken。
options.success ：Function(res) required 验证成功的回调。res 包含验证成功的 token。
options.fail ：Function(err) required 验证失败的回调。err 包含错误码、错误信息。

5. 完整示例参考

DEMO 示例：意愿核身 demo

6. 已有项目切换成意愿核身

1. 完成 接入准备 中的前置条件配置。
2. 下载并更新 SDK 为 意愿核身小程序 SDK。
3. 参考步骤2，在第7点配置意愿确认时勾选是，增加意愿确认。
4. 接入方服务端调用实名核身鉴权 DetectAuth 接口，传入意愿核身所需字段，获取到核身流程标识（BizToken）。
可在 Config 参数中选择的所需意愿核身类型（问答模式/点头确认模式），使用 IntentionQuestions.N 或 IntentionActions.N 传入问答模式或点头确认模式的语音播报内容。
建议开启 Config 中的 IntentionRecognition（意图识别）开关，可提升语音识别通过率。
5. 用户完成人脸核身后，会以回调函数形式返回 BizToken ，接入方小程序将 BizToken 传给接入方服务端，接入方服务端即可凭借 BizToken 参数调用获取实名核身结果信息增强版 GetDetectInfoEnhanced 接口去获取本次核身的详细信息，最后将核身结果返回给接入方小程序。
中国站