申请退款
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,需要电商平台侧有配置绑定关系才能传
transaction_id 选填 string(32)
【微信订单号】原支付交易对应的微信订单号
out_trade_no 选填 string(32)
【商户订单号】原支付交易对应的商户订单号
out_refund_no 必填 string(64)
【商户退款单号】商户系统内部的退款单号,商户系统内部唯一,只能是数字、大小写字母_-|*@ ,同一退款单号多次请求只退一笔。
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,则商户平台上配置的回调地址将不会生效,优先回调当前传的这个地址。
refund_account 选填 string(32)
【退款出资商户】REFUND_SOURCE_PARTNER_ADVANCE : 电商平台垫付,需要向微信支付申请开通REFUND_SOURCE_SUB_MERCHANT : 二级商户,默认值注意:若传入REFUND_SOURCE_PARTNER_ADVANCE,仅代表可以使用垫付退款,实际出款账户需以退款申请受理结果或查单结果为准。
funds_account 选填 string(32)
【资金账户】若订单处于待分账状态,可以传入此参数,指定退款资金来源账户。当该字段不存在时,默认使用订单交易资金所在账户出款,即待分账时使用不可用余额的资金进行退款,已分账或无分账时使用可用余额的资金进行退款。AVAILABLE:可用余额