# 微信人脸核身2.0

## 一、能力介绍

随着政务、医疗、教育、交通等行业实名制政策的深化落地，开发者对“实人验证”的需求日益凸显。为响应这一合规趋势，平台依托腾讯公司及微信的生物识别技术，构建了“实人验证”能力，即通过人脸识别+权威数据源比对，实现对“用户实名信息”与“本人操作”的验证（简称微信人脸核身）。

目前该能力限定主体及行业类目开放公测，提供给资质符合要求的业务方，在合适的业务场景内使用。目前仅支持持二代身份证的大陆居民。

由于微信人脸核身能力涉及到用户的敏感、隐私信息，因此该能力的小程序，需要满足一定的条件。即：小程序的主体以及类目，需要在限定的类目范围内，且与小程序的业务场景一致。开展的业务也需要是国家相关法规、政策规定的需要“实名办理”的相关业务，其他未在范围内的业务，则暂不支持。

微信人脸核身能力针对小程序开放的主体类目范围见附录。

微信人脸核身用户端表现示例图如下：

![](https://res.wx.qq.com/op_res/Jg-OjszpFo0UXD89gbK90wUgifqOJckIeKBFOj7P7mQ0zQTmCX3-tIXYAeAUdGdXnYC4qiJ7ckqXO1DIdqAZPw)

## 二、接入流程

### 第1步：登录打开「小程序管理后台」——「行业能力」——「人脸核身」路径，点击 "开通" 按钮。

![](https://res.wx.qq.com/op_res/llBt-RWT18d70gtXIdqGRom-JugUHXOYqS8Qni1CFKiBY13G3It4-2yHKaIqxZIZb2BA9pANurFRA_XhcMH2Bw)

### 第2步：仔细查阅《微信人脸核身功能服务条款》后，点击 "同意并下一步" 按钮。

![](https://res.wx.qq.com/op_res/AytZNpVx0EUI4q6VkGz0W1j3eSaHt74HU88zWJiExjrdUXvB4VmT0fn_NdUS14og_0eNraa1fmNxMfo5M39Hlw)

### 第3步：请正确填写服务信息，并上传该小程序类目下所要求的资质。

![](https://res.wx.qq.com/op_res/AytZNpVx0EUI4q6VkGz0Wyv2exM0DzHMS8UYr8_pzUD9lEAzoDVXS8NjBlTNxZUJCoMRJZeK4_QWPzKQpA8RaQ)

### 第4步：请按照业务实际需求填写使用微信人脸核身能力的场景和用途。

![](https://res.wx.qq.com/op_res/AytZNpVx0EUI4q6VkGz0W6U-tZE-0WjtwFx2tu2as1V1scsVQYSBQIuS-qufhhZM4-jZ2EmHFt0ol5BbvRxwTw)

### 第5步：请完善测试信息和联系人。

![](https://res.wx.qq.com/op_res/AytZNpVx0EUI4q6VkGz0Wy78wKui0lJ45g-jF1njKS5NYxEh-6x-owrplRJ0ljCwbaw7uKhUyWVwcff0HiGQ8g)

### 第6步：提交后请耐心等待 1-3 个工作日的审核期，审核结果将以站内信通知。

如申请期间遇到问题，可联系腾讯工作邮箱 `wx_city@tencent.com` ，将会有相关工作人员进一步指引。

## 三、开发流程

### 3.1 时序图

![](https://res8.wxqcloud.qq.com.cn/wxdoc/b8ea206a-1eed-4a53-856e-c7c6d46cba72.png)

### 3.2 开发流程

#### 1） 检查设备是否支持人脸识别能力

小程序调用 [wx.checkIsSupportFacialRecognition](/miniprogram/dev/api/open-api/face/wx.checkIsSupportFacialRecognition.md) 接口可以检测当前手机设备是否支持人脸识别能力，建议调用后对手机设备不支持的用户做对应功能处理。

#### 2）小程序后台根据用户实名信息调用微信后台接口获取人脸核身会话唯一标识

小程序后台需要根据「用户实名信息（姓名+身份证）」调用微信后台 [getVerifyId](/miniprogram/dev/server/API/face/api_getverifyid.md) 接口获取人脸核身会话唯一标识 verifyId 字段，然后给到小程序前端调用 [wx.requestFacialVerify](/miniprogram/dev/api/open-api/face/wx.requestFacialVerify.md) 接口使用。

#### 3）小程序前端调用微信人脸核身接口进行人脸识别

从小程序后台拿到人脸核身会话唯一标识 verifyId 字段后，小程序前端调用 [wx.requestFacialVerify](/miniprogram/dev/api/open-api/face/wx.requestFacialVerify.md) 接口，对用户进行基于生物识别的人脸核身验证。

#### 4）小程序后台根据人脸核身会话唯一标识进行用户实名信息校验

小程序前端调用 [wx.requestFacialVerify](/miniprogram/dev/api/open-api/face/wx.requestFacialVerify.md) 接口完成人脸核身请求后，需要通知小程序后台根据本次人脸核身会话唯一标识 verifyId 字段调用微信后台 [queryVerifyInfo](/miniprogram/dev/server/API/face/api_queryverifyinfo.md) 接口查询人脸核身真实验证结果。

**请注意：为保障业务可用性和安全性，务必调用 [queryVerifyInfo](/miniprogram/dev/server/API/face/api_queryverifyinfo.md) 接口，查询用户人脸核身真实验证结果。**

#### 5） 示例代码

```js
// 检查设备是否支持人脸识别能力
wx.checkIsSupportFacialRecognition({
  success() {
    // 支持人脸识别
    // 调用微信人脸核身接口进行人脸识别
    wx.requestFacialVerify({
    // 人脸核身会话唯一标识（小程序后台根据「用户实名信息（姓名+身份证）」调用微信后台 getVerifyId 接口获取）
    verifyId: '',
    success(res) {
        // 人脸核身验证成功，需要通知小程序后台根据本次人脸核身会话唯一标识 verifyId 字段调用微信后台 queryVerifyInfo 接口查询人脸核身真实验证结果。
    },
    fail() {
        // 人脸核身验证失败
    },
    })
  },
  fail() {
    // 不支持人脸识别
  },
})
```

## 四、常见问题

### Q：微信人脸核身1.0和2.0接口有什么区别？

**微信人脸核身2.0是[微信人脸核身1.0](https://developers.weixin.qq.com/community/business/doc/000442d352c1202bd498ecb105c00d)的升级版本，调用规则更加清晰，接口能力更加安全可靠，用户C端体验保持不变。若小程序仍在使用微信人脸核身1.0服务，建议尽快升级至更加安全可靠的2.0接口。**

### Q：小程序已经有微信人脸核身1.0权限，升级2.0需重新申请权限吗?

若小程序此前已有[微信人脸核身1.0](https://developers.weixin.qq.com/community/business/doc/000442d352c1202bd498ecb105c00d)接口权限，**不需要**重新申请2.0接口权限，直接调用2.0接口即可。若小程序此前无[微信人脸核身1.0](https://developers.weixin.qq.com/community/business/doc/000442d352c1202bd498ecb105c00d)接口权限，请按照2.0中的接入流程申请接口权限。

### Q：部分低版本客户端用户无法拉起人脸核身2.0？

**[人脸核身2.0接口](/miniprogram/dev/api/open-api/face/wx.requestFacialVerify.md)要求最低基础库版本为3.8.12，低于此版本会导致调用失败。建议对API兼容性做检测与降级处理。**

如何检测：查看[兼容性处理指南](/miniprogram/dev/framework/compatibility.md)。检查 wx.requestFacialVerify 是否存在`if (wx.requestFacialVerify)`。

结果处理：支持时，可调用 wx.requestFacialVerify；不支持时，小程序前端提示用户升级至微信客户端最新版。

### Q：调用微信人脸核身2.0需要配置IP白名单吗？

调用人脸核身2.0 api 时需使用`access_token`，获取`access_token`需前置配置IP白名单，
配置方式请参考[API IP 白名单](/doc/oplatform/developers/basic_func/ip_whitelist.md)。

### Q：微信公众平台没有微信人脸核身申请入口？

如无申请入口，请先自查小程序类目是否在微信人脸核身2.0准入类目范围。

### Q：微信人脸核身2.0支持核验哪些证件？

目前仅支持核验二代身份证。

### Q：姓名包含生僻字如何进行人脸核身？

姓名生僻字问题通常源于系统字库缺失该字字形，请引导用户通过以下方式处理：

1. 1.访问[姓名生僻字处理平台](https://name.vurls.cn/ui/index/rkxx)
2. 2.在「户籍查字」目录下，按生僻字组成搜索，并复制平台用 PUA 码造出的生僻字；
3. 3.将复制的字粘贴到姓名输入框并发起人脸核身。因本地字库缺字形，显示空白或乱码属正常现象。

### Q：少数民族姓名中间的「·」间隔符，手机端如何输入？

请引导用户通过以下方式处理：

1. 1.通过输入法输入：调出手机输入法键盘后，点击键盘上的「符」或「符号」按键（通常位于键盘左下角或右下角），切换到「中文」或「常用」符号分类，即可找到并输入「·」。
2. 2.如无法找到对应符号，可直接复制本文提供的标准间隔符「·」粘贴使用。

### Q：人脸核身时提示“未能通过人脸检测”或“请求异常，请稍后再试”？

请先按以下建议引导用户调整操作环境及姿势后重试。若多次尝试仍无法通过，请和我们联系。

1. 1.选择适宜的光线环境：建议在室内或光线柔和的阴天室外进行；避免在阳光强烈的户外、正对灯光，屏幕反光、强光直射的环境下操作；
2. 2.对准取景框：将手机屏幕中显示的"脸部"圆圈对准自己的面部，并用脸部尽量将其填满，避免画面中只露出部分五官；
3. 3.避免逆光：尽量不在窗户边、车内或背光位置操作，以免造成面部过暗、识别不清；
4. 4.保持手机与面部平行：手持手机时尽量与脸部保持平行，不建议低头俯视屏幕，以免角度偏差导致检测失败；
5. 5.检查是否开启手机摄像头背景虚化：背景虚化会导致人脸识别异常，可前往 “设置” > “相机” > “保留设置” > 选择 “关闭相机模式”。

### Q：人脸核身时提示“已超时，请重试”？

超时报错通常与操作距离、设备或网络有关，请引导用户按以下顺序逐一排查：

1. 1.操作距离过远：刷脸时若离屏幕过远，系统可能无法在限定时间内完成识别。请留意屏幕上的实时提示，按要求调整脸部与手机的距离和动作后重试；
2. 2.设备使用方式不当：使用平板进行核身时，须全程保持竖屏操作，横屏可能导致识别异常并触发超时；
3. 3.网络连接不稳定：网络延迟或中断会造成核身请求超时。建议切换至更稳定的网络后重新尝试。

### Q：人脸核身时提示“非法identify_id”？

该提示通常与校验参数不一致或核身凭证被复用有关，请按以下顺序排查调用逻辑：

1. 1.检查 openid 是否一致：调用 getVerifyId 获取核身凭证时传入的 openid，必须与拉起人脸核身 JSAPI 时所使用的 openid 完全一致。两者不一致会导致身份校验失败并报"非法 identify_id"。
2. 2.检查 verify_id 是否被重复使用：请勿对同一笔核身流程重复使用同一个 verify_id。建议检查后台逻辑，确认是否仅存储了首次获取的 verify_id 并在后续多次核身中反复使用；如需要再次发起核身，应重新调用 getVerifyId 获取新的 verify_id。

## 五、联系我们

开发中遇到任何疑问，可以 [点击此处](https://developers.weixin.qq.com/community/minihome/question/1421119558135676931) 通过社区反馈，将有工作人员跟进回复。

此外，也可以通过工作邮箱 `wx_city@tencent.com` 提交关于本能力的意见与建议。

## 附录

支持微信人脸核身能力的小程序主体类目包括：

```json
[
  {
    "一级类目": "物流服务",
    "二级类目": "收件/派件",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "《快递业务经营许可证》"
  },
  {
    "一级类目": "货物运输",
    "二级类目": "/",
    "三级类目": "《道路运输经营许可证》（经营范围需含网络货运）",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "教育",
    "二级类目": "学历教育（学校）",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "以下资质 2选1：\n
1. 1.公立学校：由教育行政部门出具的审批设立证明 或 《事业单位法人证书》
2. 2.私立学校：《民办学校办学许可证》与《民办非企业单位登记证书》
"
  },
  {
    "一级类目": "医疗",
    "二级类目": "公立医疗机构",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "《医疗机构执业许可证》与《事业单位法人证书》"
  },
  {
    "一级类目": "互联网医院",
    "二级类目": "/",
    "三级类目": "仅支持公立医疗机构互联网医院（2选1）：\n
1. 1.卫生健康部门的《设置医疗机构批准书》；
2. 2.《医疗机构执业许可证》（范围均需含“互联网诊疗”或名称含“互联网医院”等相关内容
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "三级私立医疗机构",
    "二级类目": "/",
    "三级类目": "仅支持三级以上私立医疗机构，提供《医疗机构执业许可证》、《营业执照》及《医院等级证书》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "政务民生",
    "二级类目": "所有二级类目",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "仅支持政府/事业单位，提供《组织机构代码证》或《统一社会信用代码证》。"
  },
  {
    "一级类目": "金融业",
    "二级类目": "银行",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "以下资质 2 选 1\n
1. 1.《金融许可证》
2. 2.《金融机构许可证》
"
  },
  {
    "一级类目": "信托",
    "二级类目": "/",
    "三级类目": "以下资质 2 选 1\n
1. 1.《金融许可证》
2. 2.《金融机构许可证》
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "公募基金",
    "二级类目": "/",
    "三级类目": "以下资质 4 选 1：\n
1. 1.《经营证券期货业务许可证》且业务范围必须包含“基金”
2. 2.《基金托管业务许可证》
3. 3.《基金销售业务资格证书》
4. 4.《基金管理资格证书》
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "证券/期货",
    "二级类目": "/",
    "三级类目": "《经营证券期货业务许可证》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "保险",
    "二级类目": "/",
    "三级类目": "以下资质 8 选 1：\n
1. 1.《保险公司法人许可证》
2. 2.《经营保险业务许可证》
3. 3.《保险营销服务许可证》
4. 4.《保险中介许可证》
5. 5.《经营保险经纪业务许可证》
6. 6.《经营保险公估业务许可证》或《经营保险公估业务备案》
7. 7.《经营保险资产管理业务许可证》
8. 8.《保险兼业代理业务许可证》
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "消费金融",
    "二级类目": "/",
    "三级类目": "银监会核准开业的审批文件与《金融许可证》与《营业执照》。",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "非金融机构自营小额贷款",
    "二级类目": "/",
    "三级类目": "仅支持省金融办监管的网络小贷主体，同时提供：\n
1. 1.《小额贷款公司经营许可证》或《小额贷款机构经营许可证》或省金融办批准文件
2. 2.申请主体资质承诺函。
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "汽车金融/金融租赁",
    "二级类目": "/",
    "三级类目": "仅支持汽车金融/金融租赁主体，同时提供：\n
1. 1.《营业执照》（公司名称包含“汽车金融” /“金融租赁”；营业范围包含“汽车金融”/“金融租赁”业务）
2. 2.《金融许可证》或银保监会及其派出机构颁发的开业核准批复文件
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "交通服务",
    "二级类目": "网约车",
    "三级类目": "快车/专车/其他网约车",
    "使用微信人脸核身能力所需资质": "（自营性网约车）提供《网络预约出租汽车经营许可证》。\n（网约车平台）提供与网约车公司的合作协议以及合作网约车公司的《网络预约出租汽车经营许可证》。"
  },
  {
    "一级类目": "航司服务",
    "二级类目": "/",
    "三级类目": "提供《公共航空运输企业经营许可证》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "机场服务",
    "二级类目": "/",
    "三级类目": "提供《民用机场使用许可证》或《运输机场使用许可证》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "公交/地铁",
    "二级类目": "/",
    "三级类目": "提供公交/地铁/交通卡公司《营业执照》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "水运",
    "二级类目": "/",
    "三级类目": "（船企）提供《水路运输许可证》。（港口）提供《港口经营许可证》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "骑车",
    "二级类目": "/",
    "三级类目": "仅支持共享单车，提供共享单车公司《营业执照》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "火车/高铁/动车",
    "二级类目": "/",
    "三级类目": "仅支持铁路局/公司官方，提供铁路局/公司《营业执照》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "长途汽车",
    "二级类目": "/",
    "三级类目": "以下资质 2 选 1 ：\n
1. 1.《道路运输经营许可证》（经营范围需含客运）
2. 2.官方指定联网售票平台（授权或协议或公开可查询文件）
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "租车",
    "二级类目": "/",
    "三级类目": "运营公司提供《备案证明》与对应公司《营业执照》，且营业执照中包含汽车租赁业务",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "高速服务",
    "二级类目": "/",
    "三级类目": "仅支持ETC发行业务，（2选1）：\n
1. 1.事业单位主体，需提供《事业单位法人证书》
2. 2.官方指定的发行单位（一发单位），需提供“官方授权或协议，或公开可查询的文件”
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "生活服务",
    "二级类目": "生活缴费",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "（供电类）提供《电力业务许可证》与《营业执照》，且《营业执照》且经营范围含供电。\n（燃气类）提供《燃气经营许可证》与《营业执照》，且《营业执照》且经营范围含供气。\n（供水类）提供《卫生许可证》与《营业执照》。\n（供热类）提供《供热经营许可证》与《营业执照》，且《营业执照》且经营范围含供热。"
  },
  {
    "一级类目": "IT科技",
    "二级类目": "基础电信运营商",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "以下资质 2 选 1：\n
1. 1.基础电信运营商：提供《基础电信业务经营许可证》
2. 2.运营商分/子公司：提供营业执照（含相关业务范围）
"
  },
  {
    "一级类目": "转售移动通信（中国移动)",
    "二级类目": "/",
    "三级类目": "仅支持虚拟运营商，同时提供：\n1.《营业执照》\n2.《增值电信业务经营许可证》（业务种类包含“通过转售方式提供的蜂窝移动通信业务”或“含在全国转售中国移动的蜂窝移动通信业务”）\n
1. 3.虚拟运营商与基础电信运营商签订的合作协议或授权文件
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "转售移动通信（中国联通)",
    "二级类目": "/",
    "三级类目": "仅支持虚拟运营商，同时提供：\n
1. 1.《营业执照》
2. 2.《增值电信业务经营许可证》（业务种类包含“通过转售方式提供的蜂窝移动通信业务”或 “含在全国转售中国联通的蜂窝移动通信业务”）
3. 3.虚拟运营商与基础电信运营商签订的合作协议或授权文件
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "转售移动通信（中国电信)",
    "二级类目": "/",
    "三级类目": "仅支持虚拟运营商，同时提供：\n
1. 1.《营业执照》
2. 2.《增值电信业务经营许可证》（业务种类包含“通过转售方式提供的蜂窝移动通信业务”或“含在全国转售中国电信的蜂窝移动通信业务”）
3. 3.虚拟运营商与基础电信运营商签订的合作协议或授权文件
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "转售移动通信（中国广电)",
    "二级类目": "/",
    "三级类目": "仅支持虚拟运营商，同时提供：\n
1. 1.《营业执照》
2. 2.《增值电信业务经营许可证》（业务种类包含“通过转售方式提供的蜂窝移动通信业务”或“含在全国转售中国广电的蜂窝移动通信业务”）
3. 3.虚拟运营商与基础电信运营商签订的合作协议或授权文件
",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "旅游服务",
    "二级类目": "住宿服务",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "仅支持酒店，提供《酒店业特种行业经营许可证》"
  },
  {
    "一级类目": "旅游管理单位",
    "二级类目": "/",
    "三级类目": "仅支持政府/事业单位，提供《组织机构代码证》或《统一社会信用代码证》",
    "使用微信人脸核身能力所需资质": ""
  },
  {
    "一级类目": "商业服务",
    "二级类目": "公证",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "仅支持公证处，提供《公证处执业许可证》或《事业单位法人证书》"
  },
  {
    "一级类目": "商业服务",
    "二级类目": "电子认证",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "《电子认证服务许可证》"
  },
  {
    "一级类目": "社交",
    "二级类目": "直播",
    "三级类目": "/",
    "使用微信人脸核身能力所需资质": "以下资质 2 选 1：\n
1. 1.《信息网络传播视听节目许可证》
2. 2.《网络文化经营许可证》(经营范围含网络表演）
"
  }
]
```

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（3条）
2026 年 08 月 27 日更新微信人脸核身2.0准入类目范围
2026 年 08 月 07 日常见问题更新
2026 年 04 月 09 日人脸核身准入类目中，变更转售移动通信类目下所需相关资质