通用场景
查询小程序备案的人脸核验结果
公共请求参数
业务请求参数
certify_id｜人脸核验凭证必选string[1,128]
【描述】人脸核验凭证certify_id
【示例值】5dwhckpygtkitbl78f1hj3km
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.icp.faceauth.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"certify_id":"5dwhckpygtkitbl78f1hj3km"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
certify_result_status｜人脸核验结果状态可选string(16)
【描述】人脸核验结果状态
【枚举值】
认证成功: success
认证失败: fail
未认证: init
【示例值】success
certify_result_desc｜人脸核验结果描述可选string(128)
【描述】人脸核验结果描述，当certify_result_status为fail时展示失败的原因
【示例值】人脸核验时面部被遮挡
响应示例
正常示例
异常示例
{
"alipay_open_mini_icp_faceauth_query_response": {
"code": "10000",
"msg": "success",
"certify_result_status": "success",
"certify_result_desc": "人脸核验时面部被遮挡"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| application_type_error | 应用类型不是小程序 | 请检查应用类型是否是小程序 |
| certify_id_expired | 人脸核验凭证certify_id已过期 | 人脸核验凭证certify_id已过期,有效期为三天,请重新调用发起人脸核验的接口 |
| certify_id_not_exist | 人脸核验凭证certify_id不存在 | 请输入正确的人脸核验凭证certify_id |