# 小程序认证进度查询

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：secwxaapi_queryauth

小程序认证进度查询

# 1. 调用方式

POST https://api.weixin.qq.com/wxa/sec/queryauth?access_token=ACCESS_TOKEN

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 authorizer_access_token

参数名	类型	必填	说明
taskid	string	是	认证任务id

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
task_status	number	当前任务流程的状态码：0: 初始状态；1: 任务超时, 24小时内有效；2: 用户授权拒绝；3: 用户授权同意；4: 发起人脸流程；5: 人脸认证失败；6: 人脸认证ok；7: 人脸认证后，已经提交手机号码下发验证码；8: 手机验证失败；9: 手机验证成功；11: 创建认证审核单失败；12: 创建认证审核审核单成功；14: 验证失败；15: 等待支付
auth_url	string	小程序管理员授权链接
apply_status	number	审核单状态，创建认证审核审核单成功后该值有效。0：审核单不存在；1：待支付；2：审核中；3：打回重填；4：认证通过；5：认证最终失败（不能再修改）
orderid	number	小程序后台展示的认证订单号
appid	string	小程序appid
refill_reason	string	当审核单被打回重填(apply_status=3)时有效
fail_reason	string	审核最终失败的原因(apply_status=5)时有效

本接口无特殊注意事项

请求示例

https://api.weixin.qq.com/wxa/sec/queryauth?access_token=TOKEN

{
    "taskid": "xxxx"
}

返回示例

{
  "errcode": 0,
  "errmsg": "",
  "task_status": 15,
  "apply_status": 0,
  "appid": "wx123123123123123"
}

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述	解决方案
-1	system error	系统繁忙，此时请开发者稍候再试
0	ok	ok

本接口在不同账号类型下的可调用情况：

小程序	小游戏
✔	✔