申请免确认收款授权

更新时间:2025.12.09

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

  • 若申请授权时指定了OpenID,有效期为24小时。未指定OpenID,有效期为10分钟

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

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

接口说明

支持商户:【普通服务商】

请求方式:【POST】/v3/fund-app/mch-transfer/partner/user-confirm-authorizations

请求域名:【主域名】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)

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


 user_recv_perception  选填   string(10)

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


 notify_url  必填   string(256)

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

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/partner/user-confirm-authorizations \
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    "notify_url" : "https://www.weixin.qq.com/wxpay/pay.php"
14  }'
15

应答参数

200 OK

 out_authorization_no  必填   string(32)

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


 state  必填   string

【授权状态】 授权状态

可选取值

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


 create_time  必填   string(32)

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


 package_info  必填   string(2048)

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

应答示例

200 OK

1{
2  "out_authorization_no" : "plfk2020042013",
3  "state" : "WAIT_USER_CONFIRM",
4  "create_time" : "2015-05-20T13:29:35+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

频率超限

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

403

NO_AUTH

没有相关权限

请参阅 产品介绍、开发指引

400

INVALID_REQUEST

请求不符合业务规则

请根据返回的错误信息,参阅 产品介绍、开发指引 和 接口规则处理

 

元宝AI
反馈
目录
置顶