帮你快速理解、总结文档立即下载
文档中心>人脸核身>含 UI 集成方案>计费错误码>基础版人脸核身服务错误码

基础版人脸核身服务错误码

最近更新时间:2025-08-13 11:02:11
我的收藏
本文只列出基础版人脸核身服务相关返回码及其对应的计费关系。Plus 版、增强版、E 证通、意愿核身、实证 NFC 等的服务返回码及其他对应计费关系请查阅 Plus 版人脸核身服务错误码、增强版人脸核身服务错误码、E 证通服务错误码、意愿核身服务错误码、实证 NFC 服务错误码。

微信小程序/H5(微信公众号)/H5(微信浏览器)返回码

以下为微信小程序、 H5 (微信公众号)、H5(微信浏览器)的返回码及收费关系:

系统返回码

返回码
含义
是否收费
0
成功
是
1
调用方式出错,请参考人脸核身 DetectAuth 文档进行调用
否
2
调用方式出错,请参考人脸核身 DetectAuth 文档进行调用
否
3
调用方式出错,请参考人脸核身 DetectAuth 文档进行调用
否
4
服务异常,请稍后重试或联系客服人员
否
8
服务异常,请稍后重试或联系客服人员
否
10
服务异常,请稍后重试或联系客服人员
否
12
服务异常,请稍后重试或联系客服人员
否
13
服务异常,请稍后重试或联系客服人员
否
14
本次校验已完成
否
15
Token 过期,请重试
否
16
已达到重试上限
否
17
本次流程未完成
否

微信相关返回码

返回码
含义
是否收费
201
从微信拉取图片失败,请重试
否
202
视频获取失败,请重试
否
203
无此 API 调用权限
否
204
当前公众号/小程序未完成对慧眼授权,请参照慧眼接入文档进行扫码授权,如有疑问可微信联系慧眼小助手(faceid001)
否
301
当前认证人身份证号码与业务传入验证证件号码不符,请重新上传
否
302
身份证已过期,请使用有效身份证进行核验
否
303
扫描识别失败,请重新拍摄
否

活体检测返回码

活体通用返回码

返回码
含义
是否收费
1001
引擎超时,请稍后重试
否
1002
疑似非真人录制
否
1003
人脸识别验证未成功,请重试
否
1004
人脸验证失败,请重试
否
1005
人脸验证失败,请重试
否
1006
证照库出错,请重试
否
1007
未拉取微信活体结果或拉取微信活体结果失败
否
1008
用户活体过程网络不稳定,请切换网络环境后重试
否

数字活体返回码

返回码
含义
是否收费
1101
声音未能识别,请大声慢读一遍数字
否
1102
脸部未完整露出,请保持正脸面对屏幕
否
1103
声音未能识别,请大声慢读一遍数字
否
1104
视频格式出错无法检测,请更换手机进行验证
否
1105
视频拉取失败,请重试
否
1106
声音太小,请大声慢读一遍数字
否
1107
视频为空,或大小不合适,请控制录制时长在6s左右
否
1108
视频像素太低无法检测,请更换手机进行验证
否
1109
未识别到唇动,请大声慢读一遍数字
否

动作活体返回码

返回码
含义
是否收费
1201
光线不佳,建议在光源充足的室内环境验证
否
1202
光线不佳,建议在光源充足的室内环境验证
否
1203
离屏幕太近或太远,请确保人脸清晰完整
否
1204
离屏幕太近或太远,请确保人脸清晰完整
否
1205
离屏幕太近或太远,请确保人脸清晰完整
否
1206
离屏幕太近或太远,请确保人脸清晰完整
否
1207
动作未能识别,请按顺序缓慢做动作
否
1208
动作未能识别,请按顺序缓慢做动作
否
1209
动作未能识别,请按顺序缓慢做动作
否
1210
动作未能识别,请按顺序缓慢做动作
否

静默活体返回码

返回码
含义
是否收费
1301
疑似非真人录制,请重试
否
1302
人脸验证失败,请重试
否
1303
视频录制时间过短,请重新录制2秒以上的视频
否

证件图像比对返回码

返回码
含义
是否收费
2006
姓名和身份证号不匹配,请核实身份后重试
是
2016
无法判断为同一人,请确认身份后重试(相似度未达到通过阈值)
是
2001
引擎超时,请稍后重试
否
2002
姓名有误,请确认后重试
否
2003
身份证号有误,请确认后重试
否
2004
视频提取照片出错,请重试或更换手机进行验证
否
2005
未查询到身份信息,请通过其他渠道验证
否
2007
未查询到照片信息,请通过其他渠道验证
否
2008
未查询到照片信息,请通过其他渠道验证
否
2009
查询到照片分辨率过低,请通过其他渠道验证
否
2010
脸部未完整露出,请保持正脸面对屏幕
否
2011
无法判断为同一人,请确认身份后重试(疑似非活体)
否
2012
检测到多张人脸,请保持验证视频中只有本人
否
2013
脸部未完整露出,请保持正脸面对屏幕
否
2014
视频像素太低无法检测,请更换手机进行验证
否
2015
无法判断为同一人,请确认身份后重试(比对失败)
否
2017
权威数据源升级中,请稍后再试
否
2018
操作过于频繁,请第二天0点后重试
否

App SDK/ H5(移动端浏览器) 返回码

以下为 App SDK、H5(移动端浏览器)的返回码及收费关系:
返回码
返回信息
是否收费
0
认证通过
是
66660004
无法确认为同一人
是
66660010
姓名和身份证不一致,请确认
是
-5008
声音未能识别,请大声慢读一遍数字
否
-5018
未识别到指定动作
否
-5023
光线太强,请到室内识别
否
999999
网络不给力,请稍后重试
否
66660000
请求参数异常
否
66660002
服务不可用(已欠费或主动停服,请联系技术支持确认)
否
66660003
试用版最大刷脸次数已超
否
66660005
此证件信息不支持校验
否
66660011
未完成认证或认证结果已过期
否
66660015
姓名或身份证号格式不正确
否
66660016
视频或图片异常
否
66660017
验证次数超限
否
66660018
操作超时,请退出重试
否
66660023
请确保本人操作且正脸对框
否
66660035
未识别到人脸,请确保正脸对框且清晰完整
否
66660037
照片出现多张脸
否
66660041
脸部有遮挡或闭眼,请重试
否
66660044
应用服务版本过低,请升级
否
66660046
比对源照片无法处理
否
66662001
无此授权结果
否
66665001
请确保本人操作且正脸对框
否
400101
签名校验不通过
否
400103
IP 未加入白名单列表(请线下联系技术支持进行配置)
否
400106
不合法请求
否
400506
请求频率过高,请稍后再试
否
400600
微信下载视频失败,请重试
否
400601
视频或图片异常
否