接入文档
FaceID基础版
计费状态码
计费状态码
# 1 APP接入方式计费状态码
# 1.1 FaceID基础版（V3-SDK）计费状态码
| 结果状态码（result_code） | 返回信息（result_message） | 含义解释 | 是否计费 |
|---|---|---|---|
| 1000 | SUCCESS | 活体验证通过，比对通过 | 是 |
| 2000 | PASS_LIVING_NOT_THE_SAME | 活体验证通过，比对失败 | 是 |
| 3000 | NO_ID_CARD_NUMBER | 参考数据错误，可能原因：无此身份证号、照片格式错误、照片中找不到人脸等可能 | 是 |
| 3000 | ID_NUMBER_NAME_NOT_MATCH | 证件号码和姓名不匹配 | 是 |
| 3000 | NO_FACE_FOUND | 参考数据错误，可能原因：无此身份证号、照片格式错误、照片中找不到人脸等可能 | 是 |
| 3000 | NO_ID_PHOTO | 参考数据错误，可能原因：无此身份证号、照片格式错误、照片中找不到人脸等可能 | 是 |
| 3000 | PHOTO_FORMAT_ERROR | 参考数据错误，可能原因：无此身份证号、照片格式错误、照片中找不到人脸等可能 | 是 |
# 1.2 FaceID基础版（V2-SDK）计费状态码
| HTTP状态码 | 返回信息（error_message） | 含义解释 | 是否计费 |
|---|---|---|---|
| 400 | IMAGE_ERROR_UNSUPPORTED _FORMAT |
参数对应的图像无法正确解析，有可能不是一个图像文件、或有数据破损 ●当取值为data_source时，表示参考数据返回的图片无法解析、或者没有照片。注意：这对应Verify 1.0 API里的错误码 400（IDCARD_NO_PHOTO） |
是 |
| 400 | NO_FACE_FOUND | 从参考图像、用户传递的image图像，或是用户传递image_ref图像中没有找到人脸。请注意：只会有一项，即第一个满足条件的名称 ● 当KYC验证时，如果参考数据没有指定人的图像、或者图像里没有检测到人脸，参数值为data_source |
是 |
| 400 | NO_SUCH_ID_NUMBER | KYC验证时，参考数据中没有此证件号码的记录 | 是 |
| 400 | ID_NUMBER_NAME_NOT_MATCH | KYC验证时，参考数据中存在此证件号码，但与提供的姓名不匹配 | 是 |
# 2 H5接入方式计费状态码
H5产品在活体结束会计费，对账时可通过比对结果接口（get_result）来获取计费状态码
| HTTP状态码 | 返回信息（verify_result的error_message） | 含义解释 | 是否计费 |
|---|---|---|---|
| 200 | NULL | 没有错误 | 是 |
| 200 | NO_SUCH_ID_NUMBER | 没有此身份证号码的记录 | 是 |
| 200 | ID_NUMBER_NAME_NOT_MATCH | 身份证号码与提供的姓名不匹配 | 是 |
| 200 | IMAGE_ERROR_UNSUPPORTED_FORMAT | 姓名和身份证号正确，但图片无法解析或者没有可比对图片 | 是 |
| 200 | NO_FACE_FOUND | 对应的图像没有检测到人脸 | 是 |
| 200 | DATA_SOURCE_ERROR | 调用比对数据发生错误，一般来说是数据出错 | 否 |
| 200 | INTERNAL_ERROR | 服务器内部错误，当此类错误发生时请再次请求 | 否 |
| HTTP状态码 | 返回信息（error_message） | 含义解释 | 是否计费 |
|---|---|---|---|
| 400 | RESULT_NOT_FOUND | 此错误类型表示传入的业务编号错误 | 否 |
| 400 | VIDEO_FACE_OCCLUDE | 上传的视频中人脸被遮挡 | 否 |
| 403 | AUTHENTICATION_ERROR | api_key和api_secret不匹配 | 否 |
| 403 | AUTHORIZATION_ERROR | api_key被停用、调用次数超限、没有调用此API的权限，或者没有以当前方式调用此API的权限。目前的< reason >有：Denied. （没有权限调用当前API） | 否 |
| 403 | CONCURRENCY_LIMIT_EXCEEDED | 并发数超过限制 | 否 |
| 400 | MISSING_ARGUMENTS | 缺少某个必选参数 | 否 |
| 403 | DATA_DESTROYED | 超过可查询时间或超过最多可查询次数 | 否 |
| 400 | BAD_ARGUMENTS | 某个参数解析出错（比如必须是数字，但是输入的是非数字字符串; 或者长度过长，etc.） | 否 |
| 404 | API_NOT_FOUND | 所调用的API不存在 | 否 |
| 500 | INTERNAL_ERROR | 服务器内部错误，当此类错误发生时请再次请求，如果持续出现此类错误，请及时联系FaceID客服或商务 | 否 |
# 3 PC接入方式计费状态码
| HTTP状态码 | 返回信息（VERIFY_API_FAILED） | 含义解释 | 是否计费 |
|---|---|---|---|
| 400 | NO_FACE_FOUND | 姓名和身份证号码正确，但照片没有检测到人脸 | 是 |
| 400 | NO_SUCH_ID_NUMBER | 没有此身份证号码的记录。此错误会产生计费 | 是 |
| 400 | ID_NUMBER_NAME_NOT_MATCH | 身份证号码与提供的姓名不匹配。此错误会产生计费 | 是 |
| 400 | IMAGE_ERROR_UNSUPPORTED_FORMAT | 姓名和身份证号正确，但图片无法解析或者没有可比对图片。此错误会产生计费 | 是 |
# 4 RAW纯接口接入方式计费状态码
| HTTP状态码 | 返回信息（VERIFY_API_FAILED） | 含义解释 | 是否计费 |
|---|---|---|---|
| 400 | NO_FACE_FOUND | 姓名和身份证号码正确，但照片没有检测到人脸 | 是 |
| 400 | NO_SUCH_ID_NUMBER | 没有此身份证号码的记录。此错误会产生计费 | 是 |
| 400 | ID_NUMBER_NAME_NOT_MATCH | 身份证号码与提供的姓名不匹配。此错误会产生计费 | 是 |
| 400 | IMAGE_ERROR_UNSUPPORTED_FORMAT | 姓名和身份证号正确，但图片无法解析或者没有可比对图片。此错误会产生计费 | 是 |
该文档未解决您的疑问？
查看常见问题
查看常见问题