當(dāng)交易發(fā)生之后一段時間內(nèi)，由于買家或者賣家的原因需要退款時，賣家可以通過退款接口將支付款退還給買家，微信支付將在收到退款請求并且驗證成功之后，按照退款規(guī)則將支付款按原路退到買家賬戶上。
- 交易時間超過一年的訂單無法提交退款（按支付成功時間+365天計算）。
- 微信支付退款支持單筆交易分多次退款，多次退款需要提交原支付訂單的商戶訂單號和設(shè)置不同的退款單號。申請退款總金額不能超過訂單金額。 一筆退款失敗后重新提交，請不要更換退款單號，請使用原商戶退款單號。
- 請求頻率限制：150qps，即每秒鐘正常的申請退款請求次數(shù)不超過150次，單筆訂單請求頻率限制：1qpm，即單筆訂單每分鐘申請退款請求次數(shù)不超過1次。
- 每個支付訂單的部分退款次數(shù)不能超過50次。
- 申請退款接口的返回僅代表業(yè)務(wù)的受理情況，具體退款是否成功，需要通過退款查詢接口獲取結(jié)果。
- 當(dāng)二級商戶退款賬戶余額不足時，可發(fā)起墊付退款，從電商平臺指定賬戶墊付退款資金。當(dāng)二級商戶退款賬戶余額充足時，可把退款墊付的資金回補到電商平臺賬戶。墊付退款需要向微信支付申請開通權(quán)限，開通權(quán)限時需要指定一個墊付出款賬戶。
# 接口說明
支持商戶：
【普通服務(wù)商】
請求方式：
【POST】/v3/ecommerce/refunds/apply
請求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ，指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請設(shè)置為
application/json - Content-Type 必填 string請設(shè)置為
application/json
Header HTTP頭參數(shù)
- sub_mchid 必填 string(32)【二級商戶號】 微信支付分配二級商戶的商戶號
- sp_appid 必填 string(32)【電商平臺APPID】 電商平臺在微信公眾平臺申請服務(wù)號對應(yīng)的APPID，申請商戶功能的時候微信支付會配置綁定關(guān)系
- sub_appid 選填 string(32)【二級商戶APPID】 二級商戶在微信申請公眾號成功后分配的帳號ID，需要電商平臺側(cè)有配置綁定關(guān)系才能傳
- transaction_id 選填 string(32)【微信訂單號】 原支付交易對應(yīng)的微信訂單號
- out_trade_no 選填 string(32)【商戶訂單號】 原支付交易對應(yīng)的商戶訂單號
- out_refund_no 必填 string(64)【商戶退款單號】 商戶系統(tǒng)內(nèi)部的退款單號，商戶系統(tǒng)內(nèi)部唯一，只能是數(shù)字、大小寫字母_-|*@ ，同一退款單號多次請求只退一筆。
- reason 選填 string(80)【退款原因】 若商戶傳入，會在下發(fā)給用戶的退款消息中體現(xiàn)退款原因
- amount 必填 RefundReqAmount【訂單金額】 訂單金額信息
- 屬性
- notify_url 選填 string(256)【退款結(jié)果回調(diào)url】 異步接收微信支付退款結(jié)果通知的回調(diào)地址，通知url必須為外網(wǎng)可訪問的url，不能攜帶參數(shù)。 如果參數(shù)中傳了notify_url，則商戶平臺上配置的回調(diào)地址將不會生效，優(yōu)先回調(diào)當(dāng)前傳的這個地址。
- refund_account 選填 string(32)【退款出資商戶】 REFUND_SOURCE_PARTNER_ADVANCE : 電商平臺墊付，需要向微信支付申請開通
REFUND_SOURCE_SUB_MERCHANT : 二級商戶，默認(rèn)值
注意：若傳入REFUND_SOURCE_PARTNER_ADVANCE，僅代表可以使用墊付退款，實際出款賬戶需以退款申請受理結(jié)果或查單結(jié)果為準(zhǔn)。 - funds_account 選填 string(32)【資金賬戶】 若訂單處于待分賬狀態(tài)，可以傳入此參數(shù)，指定退款資金來源賬戶。當(dāng)該字段不存在時，默認(rèn)使用訂單交易資金所在賬戶出款，即待分賬時使用不可用余額的資金進(jìn)行退款，已分賬或無分賬時使用可用余額的資金進(jìn)行退款。
AVAILABLE：可用余額
Body 包體參數(shù)
請求示例
POST
# 應(yīng)答參數(shù)
- refund_id 必填 string(32)【微信支付退款訂單號】 微信支付退款訂單號
- out_refund_no 必填 string(64)【商戶退款單號】 商戶系統(tǒng)內(nèi)部的退款單號，商戶系統(tǒng)內(nèi)部唯一，只能是數(shù)字、大小寫字母_-|*@ ，同一退款單號多次請求只退一筆。
- create_time 必填 string(64)【退款創(chuàng)建時間】 退款受理時間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領(lǐng)先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示，北京時間2015年5月20日13點29分35秒。
- amount 必填 RefundAmount【退款金額】 訂單退款金額信息
- 屬性
- promotion_detail 選填 array[PromotionDetail]【優(yōu)惠退款詳情】 優(yōu)惠退款功能信息
- 屬性
- refund_account 選填 string(32)【退款出資商戶】 REFUND_SOURCE_PARTNER_ADVANCE : 電商平臺墊付
REFUND_SOURCE_SUB_MERCHANT : 二級商戶，默認(rèn)值
注意：申請退款時可能會出現(xiàn)暫未扣除退款資金的情況，此時不返回本字段，需查單確認(rèn)。
200OK
應(yīng)答示例
200 OK
# 錯誤碼
# 公共錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
| 400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
| 401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
| 500 | SYSTEM_ERROR | 系統(tǒng)異常，請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 請求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則 | 此狀態(tài)代表本次請求的退款申請失敗，請根據(jù)具體的錯誤提示做相應(yīng)處理 |
| 400 | MCH_NOT_EXISTS | 商戶號不存在 | 請檢查商戶號是否正確 |
| 401 | SIGN_ERROR | 簽名錯誤 | 請檢查簽名參數(shù)和方法是否都符合簽名算法要求 |
| 403 | NO_AUTH | 沒有退款權(quán)限 | 此狀態(tài)代表退款申請失敗，請檢查是否有退這筆訂單的權(quán)限 |
| 403 | NOT_ENOUGH | 余額不足 | 根據(jù)提示進(jìn)行充值后重試 |
| 403 | USER_ACCOUNT_ABNORMAL | 用戶賬戶異常或已注銷，不能原路退回，請使用其他方式進(jìn)行退款 | 此狀態(tài)代表退款申請失敗，商戶可自行處理退款。或前往服務(wù)商 (opens new window)-交易中心，重新發(fā)起退款 |
| 404 | RESOURCE_NOT_EXISTS | 訂單不存在 | 請檢查訂單號是否正確且是否已支付，未支付的訂單不能發(fā)起退款 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 該筆退款未受理，請降低頻率后重試 |
| 500 | SYSTEM_ERROR | 接口返回錯誤 | 請不要更換商戶退款單號，請使用相同參數(shù)再次調(diào)用API |
