商户单号查询自动收款授权

更新时间:2025.04.22

根据商户单号用户自动收款授权的详细信息。

注:单个商户的接口频率限制为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 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

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


Accept  必填 string

请设置为application/json


path 路径参数

out_authorization_no  必填 string(32)

【商户侧授权单号】 商户系统内部的自动收款授权单号。

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/user-confirm-authorization/out-authorization-no/plfk2020042013 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

out_authorization_no  必填 string(32)

【商户侧授权单号】 商户系统内部的自动收款授权单号。


appid  必填 string(32)

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


openid  必填 string(64)

【收款用户OpenID】 收款用户在商户appid下的唯一标识。


user_display_name  必填 string(32)

【用户展示昵称】 用户自动收款授权详情中展示的昵称。


authorization_id  必填 string(32)

【微信自动收款授权单号】 用户确认授权后微信支付返回的授权单号。


state  必填 string

【授权状态】 授权状态

可选取值

  • TAKING_EFFECT: 用户已确认授权,授权生效中,可发起转账到授权对应的用户

  • CLOSED: 用户或商户系统关闭,无法转账至该授权对应的用户


authorize_time  必填 string(32)

【用户确认授权的时间】 按照使用rfc3339所定义的格式,格式为yyyy-MM-DDThh:mm:ss+TIMEZONE


close_info  选填 object

【自动收款授权的关闭信息】 当状态为已关闭时返回,如关闭原因、关闭时间等

属性

应答示例

200 OK

1{
2  "out_authorization_no" : "plfk2020042013",
3  "appid" : "102022609",
4  "openid" : "216BE837A39456BD6729F6F47D7C0EEE",
5  "user_display_name" : "wx_123456",
6  "authorization_id" : "201202504101000123456789012",
7  "state" : "TAKING_EFFECT",
8  "authorize_time" : "2015-05-20T13:29:35.120+08:00",
9  "close_info" : {
10    "close_time" : "2015-05-20T13:29:35.120+08:00",
11    "close_reason" : "USER_CLOSE"
12  }
13}
14

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

404

NOT_FOUND

自动收款授权不存在

检查传入的授权单号

429

RATELIMIT_EXCEEDED

频率超限

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

 

 

反馈
咨询
目录
置顶