后台返回码
以下为慧眼人脸核身 SDK 的后台返回码及收费关系：
系统返回码
返回码 | 含义 | 是否收费 |
0 | 成功 | 是 |
2 | 调用方式出错，请参考人脸核身文档进行调用 | 否 |
3 | 调用方式出错，请参考人脸核身文档进行调用 | 否 |
4 | 服务异常，请稍后重试或联系客服人员 | 否 |
7 | 服务异常，请稍后重试或联系客服人员 | 否 |
8 | 服务异常，请稍后重试或联系客服人员 | 否 |
14 | 本次校验已完成 | 否 |
15 | token 过期，请重试 | 否 |
17 | 调用方式出错，请参考人脸核身文档进行调用 | 否 |
18 | 超出限频次数 | 否 |
19 | 超出有效期 | 否 |
活体检测返回码
返回码 | 含义 | 是否收费 |
1001 | 引擎超时，请稍后重试 | 否 |
1003 | 人脸识别验证未成功，请重试 | 否 |
1004 | 人脸验证失败，请重试 | 否 |
1005 | 人脸验证失败，请重试 | 否 |
1007 | 活体检测失败，命中风控逻辑 | 否 |
1202 | 光线不佳，建议在光源充足的室内环境验证 | 否 |
证件图像比对返回码
返回码 | 含义 | 是否收费 |
2001 | 引擎超时，请稍后重试调 | 否 |
2002 | 姓名有误，请确认后重试 | 否 |
2003 | 身份证号有误，请确认后重试 | 否 |
2004 | 视频提取照片出错，请重试或更换手机进行验证 | 否 |
2005 | 未查询到身份信息，请通过其他渠道验证 | 否 |
2006 | 姓名和身份证号不匹配，请核实身份后重试 | 是 |
2007 | 未查询到照片信息，请通过其他渠道验证 | 是 |
2009 | 查询到照片分辨率过低，请通过其他渠道验证 | 是 |
2011 | 无法判断为同一人，请确认身份后重试（疑似非活体） | 是 |
2012 | 检测到多张人脸，请保持验证视频中只有本人 | 是 |
2013 | 脸部未完整露出，请保持正脸面对屏幕 | 是 |
2014 | 视频像素太低无法检测，请更换手机进行验证 | 是 |
2015 | 无法判断为同一人，请确认身份后重试（比对失败） | 是 |
2016 | 无法判断为同一人，请确认身份后重试（相似度未达到通过阈值） | 是 |
2017 | 权威数据源升级中，请稍后再试 | 否 |
App SDK 错误码
以下为 SDK 的错误码及含义：
Android 错误码
错误码 | 错误码值 | 错误码含义 |
HY_NETWORK_ERROR | 210 | 网络请求出现异常 |
HY_LOCAL_REF_FAILED_ERROR | 211 | 本地初始化 SDK 时，检测失败，常见异常不存在 license 文件或者 license 过期 |
HY_USER_CANCEL_ERROR | 212 | 用户主动取消核身流程 |
HY_INNER_ERROR_CODE | 213 | SDK 内部产生的异常，终止了核身流程 |
HY_DO_NOT_CHANGE_ERROR | 214 | 在核身过程中切换应用发生终止流程的异常 |
HY_CAMERA_PERMISSION_ERROR | 215 | 获取摄像头过程中发生异常 |
HY_INIT_SDK_ERROR | 216 | 未调用 init()方法，直接调用了启动检测 |
HY_VERIFY_LOCAL_ERROR | 217 | 本地人脸检测失败 |
HY_PERMISSION_CHECK_ERROR | 218 | 本地 SDK 所需要的权限不足 |
HY_APP_STOP_ERROR | 219 | 集成者主动终止核身流程，startAuthByLightData的reflectSequence 为 null 时 |
HY_CHECK_LIVE_DATA_ERROR | 220 | 传入的光线序列参数校验失败 |
HY_INITIALIZATION_PARAMETER_EXCEPTION | 221 | 在未获取设备配置的前提下，直接调用了设置光线序列参数的方法时，会出现的异常 |
HY_VERIFY_LOCAL_TIME_OUT | 222 | 本地核身动作检测超时 |
HY_PREPARE_TIME_OUT | 223 | 准备过程超时（启动摄像头到第一次检测到人脸的时间超时） |
HY_CHECK_PERMISSION_ERROR | 224 | SDK 内部申请摄像头权限失败 |
HY_ACTION_REFLECTIVE_SDK_ERROR | 228 | 内部算法本地检测识别失败 |
iOS 错误码
错误码 | 错误码值 | 错误码含义 |
HY_NETWORK_ERROR | 272 | 网络请求出现异常 |
HY_LOCAL_REF_FAILED_ERROR | 273 | 本地初始化 SDK 时，本地检测失败，常见异常不存在 license 文件或者 license 过期 |
HY_USER_CANCEL_ERROR | 274 | 用户主动取消核身流程 |
HY_INNER_ERROR_CODE | 275 | SDK 内部产生的异常，终止了核身流程 |
HY_DO_NOT_CHANGE_ERROR | 276 | 在核身过程中切换应用发生终止流程的异常 |
HY_CAMEREA_PERMISSION_ERROR | 277 | 获取摄像头过程中发生异常 |
HY_INIT_SDK_ERROR | 278 | 未调用 init()方法，直接调用了启动检测 |
HY_VERIFY_LOCAL_ERROR | 279 | 本地人脸检测失败 |
HY_SDK_VEDIO_CUT_ERR | 282 | 本地合身视频采集失败 |
HY_SDK_TURING_TOKEN_GET_ERR | 283 | 设备风险模块调用失败 |
Harmony 错误码
错误码 | 错误码含义 |
211 | 本地初始化 SDK 时，检测失败，常见异常不存在 license 文件或者 license 过期 |
212 | 用户主动取消核身流程 |
214 | 勿在核身的过程中切换应用 |
215 | 打开摄像头过程中发生异常 |
222 | 本地核身动作检测超时 |
223 | 准备过程超时（启动摄像头到第一次检测到人脸的时间超时） |
228 | SDK 内部发生错误，详情参见对应的 error msg |
232 | 勿在核身的过程中展开或闭合折叠屏 |
300 | 公有云拉取 liveness token异常，详情参见对应的 error msg |
301 | 公有云拉取liveness result异常，详情参见对应的error msg |
GetFaceIdResult 接口风险标签说明
设备维度风险标签 DeviceInfoTag 说明
仅 plus 版支持返回，增强版默认返回值为 null。
tag 标签 | 说明 |
01 | 设备疑似被Root/设备疑似越狱。 |
02 | 设备疑似被注入。 |
03 | 设备疑似为模拟器。 |
04 | 设备疑似存在风险操作。 |
05 | 摄像头疑似被劫持。 |
06 | 疑似黑产设备。 |
null | 无设备风险，或取不到有效值。 |
