---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4014399423.md"
title: "商户单号查询授权结果"
doc_id: 4014399423
---

>更新时间：2026.05.08

根据商户单号查询用户免确认收款的授权结果。

一、通过[发起免确认收款授权](https://pay.weixin.qq.com/doc/v3/merchant/4015901167.md) 获取授权的查询规则

- 对于用户超期未确认而关闭的授权记录，系统设有 30天​ 的数据保留期

  - 保留期内查询：接口会正常返回授权详情，其中授权状态为 CLOSED ，关闭原因为 USER\_OVERDUE\_UNCONFIRMED

  - 超期后查询：接口将返回 NOT\_FOUND 错误

二、使用[发起转账并完成免确认收款授权](https://pay.weixin.qq.com/doc/v3/merchant/4014399293.md)获取授权的查询规则

- 若用户收款成功且免确认收款授权成功

  - 接口返回的HTTP状态码为200，且授权状态为 TAKING\_EFFECT
- 若用户未收款成功或收款成功但未同意免确认收款授权，或者因业务规则、风控策略等限制无法完成授权

  - 系统将不会处理授权信息，接口将返回NOT\_FOUND 错误

注意：

- 用户授权成功后，该授权长期有效，直至用户或商户系统主动解除授权。 商户系统需保存商户侧授权单号out\_authorization\_no 和 微信免确认收款授权单号authorization\_id ，避免无法再发起转账

- 单个商户的接口频率限制为100次/s





## 接口说明

支持商户：【普通商户】

请求方式：【GET】 `/v3/fund-app/mch-transfer/user-confirm-authorization/out-authorization-no/{out_authorization_no}`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| out_authorization_no | string(32) | true | 【商户侧授权单号】 商户系统内部的免确认收款授权单号。 |
### Query 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| is_display_authorization | boolean | false | 【是否展示用户授权信息】 true-是；false-否，默认否。商户可选择是否在响应中返回 package 信息，用于通过 JSAPI 或 APP 方式调起用户授权信息页。 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| out_authorization_no | string(32) | true | 【商户侧授权单号】 商户系统内部的免确认收款授权单号。 |
| appid | string(32) | true | 【商户AppID】 商户应用唯一标识 |
| openid | string(64) | true | 【收款用户OpenID】 用户在商户appid下的唯一标识 |
| user_display_name | string(32) | true | 【用户展示昵称】 用户免确认收款授权详情中展示的昵称 |
| authorization_id | string(32) | false | 【微信免确认收款授权单号】 用户确认授权后微信支付返回的授权单号 |
| state | string | true | 【授权状态】 授权状态<br>可选取值<br><ul><li>`TAKING_EFFECT`:  用户已确认授权，授权生效中，可发起转账到授权对应的用户</li><li>`CLOSED`:  用户或商户系统关闭，无法转账至该授权对应的用户</li><li>`WAIT_USER_CONFIRM`:  已受理商户的授权申请，待用户确认</li></ul> |
| authorize_time | string(32) | false | 【用户确认授权的时间】 用户确认授权后返回。按照使用rfc3339所定义的格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE |
| close_info | object | false | 【免确认收款授权的关闭信息】 当状态为已关闭时返回，如关闭原因、关闭时间等 |
| close_info.close_time | string(32) | true | 【关闭时间】 当状态为已关闭时返回，按照使用rfc3339所定义的格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE |
| close_info.close_reason | string | true | 【免确认收款授权的原因】 当状态为已关闭时返回<br>可选取值<br><ul><li>`CLOSE_VIA_MCH_API`:  商户通过API主动关闭授权</li><li>`USER_CLOSE`:  用户确认后，主动关闭授权</li><li>`USER_OVERDUE_UNCONFIRMED`:  用户超时未确认授权</li><li>`TRANSFER_RISK`:  转账存在风险</li><li>`USER_ACCOUNT_ABNORMAL`:  用户收款账户异常</li></ul> |
| transfer_scene_id | string(36) | false | 【转账场景ID】 用户授权后免确认收款的转账场景，可前往“商户平台-产品中心-商家转账”中申请。如：1000（现金营销），1006（企业报销）等 |
| user_recv_perception | string(256) | false | 【用户收款感知】 商户申请免确认收款授权时传入的内容 |
| create_time | string | false | 【单据创建时间】 商户申请授权的时间，按照使用rfc3339所定义的格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE |
| package_info | string(512) | false | 【跳转授权信息页的package信息】 跳转用户授权信息页的package信息， [JSAPI调起用户授权信息页](https://pay.weixin.qq.com/doc/v3/merchant/4012716430.md) 或 [APP调起用户授权信息页](https://pay.weixin.qq.com/doc/v3/merchant/4012719576.md) 时需要使用的参数。授权单状态为生效中时返回，package信息的有效期为10分钟，过期后须重新获取。 |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md#%E9%94%99%E8%AF%AF%E7%A0%81%E5%92%8C%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA)

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
| 404 | NOT\_FOUND | 免确认收款授权不存在 | 检查传入的授权单号 |
| 429 | RATELIMIT\_EXCEEDED | 频率超限 | 请降低请求接口频率后，使用相同参数重试 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/merchant/4014399423-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/merchant/4014399423-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/merchant/4014399423-go.md)


应答示例

> 200 OK

```
{
  "out_authorization_no" : "plfk2020042013",
  "appid" : "102022609",
  "openid" : "216BE837A39456BD6729F6F47D7C0EEE",
  "user_display_name" : "wx_123456",
  "authorization_id" : "201202504101000123456789012",
  "state" : "TAKING_EFFECT",
  "authorize_time" : "2015-05-20T13:29:35.120+08:00",
  "close_info" : {
    "close_time" : "2015-05-20T13:29:35.120+08:00",
    "close_reason" : "USER_CLOSE"
  },
  "transfer_scene_id" : "1000",
  "user_recv_perception" : "现金奖励",
  "create_time" : "2015-05-20T13:29:35.120+08:00",
  "package_info" : "0004-affffddafdfafddffda=="
}

```
