申请退款（按商户订单号）

Header  HTTP头参数

 Authorization 　必填　string

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

 Accept 　必填　string

请设置为application/json

 Content-Type 　必填　string

请设置为application/json

body  包体参数

 sub_mchid 　必填   string(32)

【二级商户号】 微信支付分配二级商户的商户号。

 sp_appid 　必填   string(32)

【电商平台APPID】 电商平台在微信公众平台申请服务号对应的APPID，申请商户功能的时候微信支付会配置绑定关系

 sub_appid 　选填   string(32)

【二级商户APPID】 二级商户在微信申请公众号成功后分配的帐号ID，需要电商平台侧有配置绑定关系才能传

 out_refund_no 　必填   string(64)

【商户退款单号】 商户系统内部的退款单号，商户系统内部唯一，只能是数字、大小写字母_-|*@ ，同一退款单号多次请求只退一笔。

 out_trade_no 　必填   string(32)

【还款明细单订单号】 商户系统内部对还款明细单定义的订单号，在同一个商户号下唯一。

 combine_mchid 　必填   string(32)

【还款服务商商户号】 还款发起方商户号，是由微信支付系统生成并分配给每个服务商的唯一标识符。

 combine_out_trade_no 　必填   string(32)

【还款订单号】 商户系统内部的交易单商户订单号，在同一个商户号下唯一。

 reason 　选填   string(80)

【退款原因】 若商户传入，会在下发给用户的退款消息中体现退款原因

 amount 　必填   object

【订单金额】 订单金额信息

属性

refund 　必填   integer 【退款金额】 退款金额，币种的最小单位，只能为整数，不能超过原订单支付金额。  from 　选填   array[object] 【退款出资账户及金额】 退款需要从指定账户出资时，传递此参数指定出资金额（币种的最小单位，只能为整数）。 该功能优先级高于通过资金账户（funds_account）参数来指定可用余额出资退款功能，且二者不可同时使用。 同时指定多个账户出资退款的使用场景需要满足以下条件：1、未开通退款支出分离产品功能；2、非电商平台垫付退款；3、订单属于分账订单，且分账处于待分账或分账中状态。 参数传递需要满足条件：1、基本账户可用余额出资金额与基本账户不可用余额出资金额之和等于退款金额；2、账户类型不能重复。 上述任一条件不满足将返回错误 属性  account 　必填   string(32) 【出资账户类型】 下面枚举值多选一。 枚举值： AVAILABLE : 可用余额 UNAVAILABLE : 不可用余额  amount 　必填   integer 【出资金额】 对应账户出资金额  total 　必填   integer 【原订单金额】 原支付交易的订单总金额，币种的最小单位，只能为整数  currency 　选填   string(16) 【退款币种】 符合ISO 4217标准的三位字母代码，目前只支持人民币：CNY

 notify_url 　选填   string(256)

【退款结果回调url】 异步接收微信支付退款结果通知的回调地址，通知url必须为外网可访问的url，不能携带参数。 如果参数中传了notify_url，则商户平台上配置的回调地址将不会生效，优先回调当前传的这个地址。

 funds_account 　选填   string

【资金账户】 若订单处于待分账状态，可以传入此参数，指定退款资金来源账户。当该字段不存在时，默认使用订单交易资金所在账户出款，即待分账时使用不可用余额的资金进行退款，已分账或无分账时使用可用余额的资金进行退款。
AVAILABLE：可用余额

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/ecommerce/refunds/apply \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "sub_mchid" : "1900000109",
8    "sp_appid" : "wx8888888888888888",
9    "sub_appid" : "wx8888888888888888",
10    "out_refund_no" : "1217752501201407033233368018",
11    "out_trade_no" : "20250506125346",    
12    "combine_mchid" : "1230000109",    
13    "combine_out_trade_no" : "P20150806125346",      
14    "reason" : "商品已售完",
15    "amount" : {
16      "refund" : 888,
17      "from" : [
18        {
19          "account" : "AVAILABLE",
20          "amount" : 444
21        }
22      ],
23      "total" : 888,
24      "currency" : "CNY"
25    },
26    "notify_url" : "https://weixin.qq.com",
27    "funds_account" : "AVAILABLE"
28  }'
29

200 OK

 refund_id 　必填   string(32)

【微信支付退款订单号】 微信支付退款订单号

 out_refund_no 　必填   string(64)

【商户退款单号】 商户系统内部的退款单号，商户系统内部唯一，只能是数字、大小写字母_-|*@ ，同一退款单号多次请求只退一笔。

 create_time 　必填   string(64)

【退款创建时间】 退款受理时间，遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。

 amount 　必填   object

【退款金额】 订单退款金额信息

属性

refund 　必填   integer 【退款金额】 退款金额，单位为分，只能为整数，不能超 过原订单支付金额  from 　选填   array[object] 【退款出资账户及金额】 退款出资的账户类型及金额信息 属性  account 　必填   string(32) 【出资账户类型】 下面枚举值多选一。 枚举值： AVAILABLE : 可用余额 UNAVAILABLE : 不可用余额  amount 　必填   integer 【出资金额】 对应账户出资金额  payer_refund 　必填   integer 【用户退款金额】 退款给用户的金额，不包含所有优惠券金额  discount_refund 　选填   integer 【优惠退款金额】 优惠券的退款金额，原支付单的优惠按比例退款  currency 　选填   string(16) 【货币类型】 符合ISO4217标准的三位字母代码，目前只支持人民币：CNY

 promotion_detail 　选填   array[object]

【优惠退款详情】 优惠退款功能信息

	属性
	promotion_id 　必填   string(32) 【券ID】 券或者立减优惠id  scope 　必填   string(32) 【优惠范围】 GLOBAL- 全场代金券 SINGLE- 单品优惠  type 　必填   string(32) 【优惠类型】 COUPON- 代金券，需要走结算资金的充值型代金券 DISCOUNT- 优惠券，不走结算资金的免充值型优惠券  amount 　必填   integer 【优惠券面额】 用户享受优惠的金额（优惠券面额=微信出资金额+商家出资金额+其他出资方金额 ）  refund_amount 　必填   integer 【优惠退款金额】 代金券退款金额<=退款金额，退款金额-代金券或立减优惠退款金额为现金，说明详见代金券或立减优惠

应答示例

200 OK

1{
2  "refund_id" : "1217752501201407033233368018",
3  "out_refund_no" : "1217752501201407033233368018",
4  "create_time" : "2018-06-08T10:34:56+08:00",
5  "amount" : {
6    "refund" : 888,
7    "from" : [
8      {
9        "account" : "AVAILABLE",
10        "amount" : 444
11      }
12    ],
13    "payer_refund" : 888,
14    "discount_refund" : 888,
15    "currency" : "CNY"
16  },
17  "promotion_detail" : [
18    {
19      "promotion_id" : "109519",
20      "scope" : "SINGLE",
21      "type" : "DISCOUNT",
22      "amount" : 5,
23      "refund_amount" : 100
24    }
25  ]
26}
27