接入文档
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 姓名和身份证号正确,但图片无法解析或者没有可比对图片。此错误会产生计费
该文档未解决您的疑问?查看常见问题