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

一、接入流程

3. 客户后端将 BizToken 返回给客户小程序端，然后小程序调用 wx.startNfcVerify() 进入 NFC 身份证件核验流程。

4. 用户完成 NFC 读卡核验后，会以回调函数形式返回 BizToken，接入方小程序将 BizToken 传给接入方服务端，接入方服务端即可凭借 BizToken 参数调用 GetWxNFCResult 接口获取本次核验的详细信息。

二、环境要求

三、下载 SDK

下载 NFC 小程序 SDK。

四、安装 SDK

将 nfc_sdk 文件夹放在小程序根目录下，使用 require 函数引入。

const Verify = require('/nfc_sdk/main');

五、调试 SDK

请在微信开发者工具中使用手机"预览"模式进行调试，请勿使用"真机调试"。NFC 读卡功能需在 Android 真机上测试。

六、卸载 SDK

卸载时删除 nfc_sdk 文件夹，移除相应 require 代码即可。

七、快速入门

1. 将 nfc_sdk 文件夹放到小程序项目根目录。

2. 初始化 NFC SDK。

·在 app.js 的 onLaunch() 中加入相应代码，在 app.json 文件里添加 NFC 验证页面 nfc_sdk/index/index。

// app.js App({ onLaunch: function () { // 初始化 NFC SDK const Verify = require('/nfc_sdk/main'); Verify.init(); } })

// app.json { "pages": [ "nfc_sdk/index/index" ] }

3. 调用 SDK 功能函数 wx.startNfcVerify()。

·在需要 NFC 身份核验的地方调用 wx.startNfcVerify() 进入核验流程，核验完成会触发对应的回调函数。

身份证类（默认）：

gotoVerify: function () { let BizToken = getBizToken(); // 客户自定义函数，从后端获取 Token wx.startNfcVerify({ data: { token: BizToken, // 必填，来自 GetNFCToken cardType: '01', // 可选，证件类型 code，默认 '01' 身份证 }, success: (res) => { // 验证成功后触发 // res.BizToken 为本次验证对应的 Token setTimeout(() => { // 验证成功后的逻辑处理 }, 500); }, fail: (err) => { // 验证失败时触发 // err.ErrorCode 错误码，err.ErrorMsg 错误信息 setTimeout(() => { wx.showModal({ title: "提示", content: err.ErrorMsg, showCancel: false }) }, 500); } });}

旅行证类（需额外传入三要素）：

gotoVerify: function () { let BizToken = getBizToken(); wx.startNfcVerify({ data: { token: BizToken, cardType: '06', // 证件类型，如港澳通行证 cardNumber: 'C12345678', // 证件号码 birthday: '910323', // 出生日期，6 位 YYMMDD expriyDay: '270320', // 有效期，6 位 YYMMDD }, success: (res) => { setTimeout(() => { // 验证成功后的逻辑处理 }, 500); }, fail: (err) => { setTimeout(() => { wx.showModal({ title: "提示", content: err.ErrorMsg, showCancel: false }) }, 500); } });}

4. 添加域名服务器白名单。

·你需要在小程序上线前进入：微信公众号管理平台 > 管理 > 开发管理 > 开发设置 > 服务器域名中将以下域名添加至白名单，小程序前端接口请求有域名白名单限制，未添加白名单的域名只能在调试模式下运行。

// request 合法域名nfc.faceid.qq.com,faceid.qq.com

八、Verify.init()

初始化 NFC SDK，需在 app.js 的 onLaunch() 中调用。

九、wx.startNfcVerify(options)

进入 NFC 身份证件核验页面。

options 参数说明：

cardType 证件类型取值：

身份证类（只需传 token）：

旅行证类（需额外传入 cardNumber / birthday / expriyDay）：

注意：传入不支持的 cardType 会自动兜底为身份证（01）。

十、错误码

注意：说明：

注意：业务层错误码（TriggerDecode 返回）透传自服务端，具体含义以慧眼服务端文档为准。

十一、步骤1：获取 Token

接入方服务端调用腾讯云 API GetNFCToken 获取 BizToken，用于发起本次 NFC 核验流程。

注意：BizToken 仅对应一次核验流程，有效时间为 600 秒；用户完成核验后，开发者可用该标识获取验证结果信息，结果信息仅保留 7 天。

十二、步骤2：调用 SDK 发起核验

客户后端将 BizToken 下发给小程序端后，调用 wx.startNfcVerify() 发起 NFC 核验流程，用户进入核验页面完成 NFC 读卡操作。

十三、步骤3：查询核验结果

用户完成 NFC 核验后，success 回调会返回 BizToken。接入方将 BizToken 传给服务端，服务端调用 GetWxNFCResult 接口获取本次核验的详细信息。

注意：在开发、产品使用、费用、合同等问题有任何疑问，欢迎你 联系我们 进行询问。