接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。
接口英文名：eccheckqrcode
可通过该接口查询扫码状态
1. 调用方式
HTTPS 调用
POST https://api.weixin.qq.com/shop/funds/qrcode/check?access_token=ACCESS_TOKEN
云调用
- 本接口不支持云调用。
第三方调用
-
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
-
该接口所属的权限集 id 为：85、116、138
-
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看 第三方调用 说明文档。
2. 请求参数
查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用） |
请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| qrcode_ticket | string | 是 | 二维码ticket，可从商户提现接口获取 |
3. 返回参数
返回体 Response Payload
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| errcode | number | 错误码 | - |
| errmsg | string | 错误信息 | - |
| status | number | 扫码状态 | 枚举值 |
| self_check_err_code | number | 业务返回错误码 | - |
| self_check_err_msg | string | 业务返回错误信息 | - |
| scan_user_type | number | 扫码者身份 | 枚举值 |
4. 枚举信息
Res.status Enum
扫码状态
| 枚举值 | 描述 |
|---|---|
| 0 | 未扫码 |
| 1 | 已确认 |
| 2 | 已取消 |
| 3 | 已失效 |
| 4 | 已扫码 |
Res.scan_user_type Enum
扫码者身份
| 枚举值 | 描述 |
|---|---|
| 0 | 非管理员 |
| 1 | 管理员 |
| 2 | 次管理员 |
5. 注意事项
本接口无特殊注意事项
6. 代码示例
请求示例
{
"qrcode_ticket":"05ba627d5b73b6f3ef0dcfc7"
}
返回示例
{
"errcode": 0,
"errmsg":"ok",
"status":0,
"self_check_err_code":0,
"self_check_err_msg":"",
"scan_user_type":1
}
7. 错误码
此接口没有特殊错误码，可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
8. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。