发起免确认收款授权

更新时间: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 使用该域名将访问异地的接入点 ,指引点击查看

请求参数
折叠全部参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为application/json


body  包体参数

 out_authorization_no  必填   string(32)

【商户侧授权单号】 商户系统内部的免确认收款授权单号,商户需保证在系统内唯一且一个用户账号对应唯一一个生效中的授权。


 appid  必填   string(32)

【商户AppID】 商户应用唯一标识


 openid  必填   string(64)

【收款用户OpenID】 用户在商户appid下的唯一标识。参考 接口参数说明


 transfer_scene_id  必填   string(36)

【转账场景ID】 用户授权后免确认收款的转账场景,可前往“商户平台-产品中心-商家转账”中申请。如:1000(现金营销),1006(企业报销)等


 user_display_name  必填   string(32)

【用户展示名称】 免确认收款授权详情中展示的“开通账号”,用于区分用户在商户侧的不同账号。不支持非utf8编码的字符和表情等特殊字符。


 user_recv_perception  选填   string(256)

【用户收款感知】 用户收款时感知到的收款原因,可查看产品文档了解,各场景展示的默认内容和支持传入的内容


 authorization_notify_url  必填   string(256)

【授权结果通知地址】 异步接收免确认收款授权结果通知的回调地址,通知url必须为公网可访问的URL,必须为HTTPS,不能携带参数。


 scene_info  选填   object

【场景信息】 用户端场景信息

属性

 client_ip  选填   string(45)

【用户终端IP】 用户端实际IP,支持IPv4和IPv6两种格式的IP地址


 device_id  选填   string(128)

【用户设备ID】 用户设备ID


 device_type  选填   string

【用户设备类型】 用户设备类型

可选取值

  • IOS:  苹果设备

  • ANDROID:  安卓设备

  • HARMONY:  鸿蒙设备

  • OTHER:  其他设备

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/user-confirm-authorization \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_authorization_no" : "plfk2020042013",
8    "appid" : "102022609",
9    "openid" : "oLTPCuFqLz_UVHHD67rLX5BxXysI",
10    "transfer_scene_id" : "1000",
11    "user_display_name" : "wx_123456",
12    "user_recv_perception" : "现金奖励",
13    "authorization_notify_url" : "https://www.weixin.qq.com/wxpay/pay.php",
14    "scene_info" : {
15      "client_ip" : "113.84.136.9",
16      "device_id" : "8d67f169fe104008cd20b72573a0c8c9",
17      "device_type" : "IOS"
18    }
19  }'
20

应答参数

200 OK

 out_authorization_no  必填   string(32)

【商户侧授权单号】 商户系统内部的免确认收款授权单号,商户需保证在系统内唯一,并且一个用户账号对应一个生效中的授权。


 state  必填   string

【授权状态】 授权状态

可选取值

  • WAIT_USER_CONFIRM:  已受理商户的授权申请,待用户确认


 create_time  必填   string

【单据创建时间】 单据受理成功时返回,按照使用rfc3339所定义的格式,格式为yyyy-MM-DDThh:mm:ss+TIMEZONE


 package_info  必填   string

【跳转授权页面的package信息】 JSAPI调起用户确认收款 时需要使用的参数。单据创建后,用户需在规定时间内完成授权。建议拉起用户授权页面前,先查单据状态。如果单据状态为待收款用户确认,可用之前获取到的package信息。单据到终态或已过期,需更换单号重新申请。

应答示例

200 OK

1{
2  "out_authorization_no" : "plfk2020042013",
3  "state" : "WAIT_USER_CONFIRM",
4  "create_time" : "2015-05-20T13:29:35.120+08:00",
5  "package_info" : "0002-affffddafdfafddffda=="
6}
7

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

429

RATELIMIT_EXCEEDED

频率超限

请降低请求接口频率后,使用相同参数重试

400

INVALID_REQUEST

当前申请单已解除或已授权成功

请检查单号,并查询授权结果

400

INVALID_REQUEST

用户在当前场景下的授权数量达到限制,不支持发起授权

请检查授权记录,避免重复发起授权

 

元宝AI
反馈
目录
置顶