---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4015901167.md"
title: "发起免确认收款授权"
doc_id: 4015901167
---

>更新时间：2026.05.08

商户调用该接口申请免确认收款授权，用户需在申请的有效期内完成授权，过期未完成需更换授权单号重新发起

- 授权申请的有效期为24小时

- 用户未确认的授权记录仅保留30天，超期后原商户授权单号out\_authorization\_no可被再次使用，以重新发起申请

- 同一微信号在当前商户的转账场景下，处于待确认（WAIT\_USER\_CONFIRM） 和 已授权（TAKING\_EFFECT）状态的授权单数量最多为 5 个

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





## 接口说明

支持商户：【普通商户】

请求方式：【POST】 `/v3/fund-app/mch-transfer/user-confirm-authorization`

请求域名：【主域名】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` |
| Content-Type | string | true | 请设置为 `application/json` |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| out_authorization_no | string(32) | true | 【商户侧授权单号】 商户系统内部的免确认收款授权单号，商户需保证在系统内唯一且一个用户账号对应唯一一个生效中的授权。 |
| appid | string(32) | true | 【商户AppID】 商户应用唯一标识 |
| openid | string(64) | true | 【收款用户OpenID】 用户在商户appid下的唯一标识。参考 [接口参数说明](https://pay.weixin.qq.com/doc/v3/merchant/4012068676.md) |
| transfer_scene_id | string(36) | true | 【转账场景ID】 用户授权后免确认收款的转账场景，可前往“商户平台-产品中心-商家转账”中申请。如：1000（现金营销），1006（企业报销）等 |
| user_display_name | string(32) | true | 【用户展示名称】 免确认收款授权详情中展示的“开通账号”，用于区分用户在商户侧的不同账号。不支持非utf8编码的字符和表情等特殊字符。 |
| user_recv_perception | string(256) | false | 【用户收款感知】 用户收款时感知到的收款原因，可查看产品文档了解，各场景展示的默认内容和支持传入的内容 |
| authorization_notify_url | string(256) | true | 【授权结果通知地址】 异步接收免确认收款授权结果通知的回调地址，通知url必须为公网可访问的URL，必须为HTTPS，不能携带参数。 |
| scene_info | object | false | 【场景信息】 用户端场景信息 |
| scene_info.client_ip | string(45) | false | 【用户终端IP】 用户端实际IP，支持IPv4和IPv6两种格式的IP地址 |
| scene_info.device_id | string(128) | false | 【用户设备ID】 用户设备ID |
| scene_info.device_type | string | false | 【用户设备类型】 用户设备类型<br>可选取值<br><ul><li>`IOS`:  苹果设备</li><li>`ANDROID`:  安卓设备</li><li>`HARMONY`:  鸿蒙设备</li><li>`OTHER`:  其他设备</li></ul> |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| out_authorization_no | string(32) | true | 【商户侧授权单号】 商户系统内部的免确认收款授权单号，商户需保证在系统内唯一，并且一个用户账号对应一个生效中的授权。 |
| state | string | true | 【授权状态】 授权状态<br>可选取值<br><ul><li>`WAIT_USER_CONFIRM`:  已受理商户的授权申请，待用户确认</li></ul> |
| create_time | string | true | 【单据创建时间】 单据受理成功时返回，按照使用rfc3339所定义的格式，格式为yyyy-MM-DDThh:mm:ss+TIMEZONE |
| package_info | string | true | 【跳转授权页面的package信息】 [JSAPI调起用户确认收款](https://pay.weixin.qq.com/doc/v3/merchant/4012716430.md) 时需要使用的参数。单据创建后，用户需在规定时间内完成授权。建议拉起用户授权页面前，先查单据状态。如果单据状态为待收款用户确认，可用之前获取到的package信息。单据到终态或已过期，需更换单号重新申请。 |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](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 | 系统异常，请稍后重试 | 请稍后重试 |
| 429 | RATELIMIT\_EXCEEDED | 频率超限 | 请降低请求接口频率后，使用相同参数重试 |
| 400 | INVALID\_REQUEST | 当前申请单已解除或已授权成功 | 请检查单号，并查询授权结果 |
| 400 | INVALID\_REQUEST | 用户在当前场景下的授权数量达到限制，不支持发起授权 | 请检查授权记录，避免重复发起授权 |

请求示例

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


应答示例

> 200 OK

```
{
  "out_authorization_no" : "plfk2020042013",
  "state" : "WAIT_USER_CONFIRM",
  "create_time" : "2015-05-20T13:29:35.120+08:00",
  "package_info" : "0002-affffddafdfafddffda=="
}

```
