提交墊付退款后,發(fā)起退款方可通過該接口發(fā)起墊付退款資金回補,把退款墊付的資金從二級商戶回補到電商平臺賬戶。
- 墊付回補結(jié)果為處理中,微信支付會在90天內(nèi)定期重試,重試結(jié)果需要查單確認。此狀態(tài)下商戶可以重試。
- 若處理中狀態(tài)重試90天后出款方賬戶仍然余額不足,回補結(jié)果將置為回補失敗,系統(tǒng)不再重試,商戶也無法重試,后續(xù)不能再發(fā)起此退款單的回補。回補處理期間請確保出款賬戶余額足夠。
- 墊付退款能力需先開通,才能使用。若需要開通,請聯(lián)系微信支付客服。
# 接口說明
支持商戶:
【普通服務(wù)商】
請求方式:
【POST】/v3/ecommerce/refunds/{refund_id}/return-advance
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設(shè)置為
application/json
- Content-Type 必填 string請設(shè)置為
application/json
Header HTTP頭參數(shù)
- refund_id 必填 string(32)【微信退款單號】 必須是墊付退款的微信退款單
Path 路徑參數(shù)
- sub_mchid 必填 string(32)【二級商戶號】 微信支付分配給二級商戶的商戶號
Body 包體參數(shù)
請求示例
POST
# 應(yīng)答參數(shù)
- refund_id 必填 string(32)【微信退款單號】 必須是墊付退款的微信退款單
- advance_return_id 必填 string(32)【微信回補單號】 微信支付生成的墊付回補操作單號
- return_amount 必填 integer【墊付回補金額】 退款單對應(yīng)的墊付退款的金額
- payer_mchid 必填 string(32)【出款方商戶號】 微信支付分配給出款方的商戶號
- payer_account 必填 string(32)【出款方賬戶】 BASIC 基本賬戶
OPERATION 運營賬戶 - payee_mchid 必填 string(32)【入賬方商戶號】 微信支付分配給入賬方的商戶號
- payee_account 必填 string(32)【入賬方賬戶】 BASIC 基本賬戶
OPERATION 運營賬戶 - result 必填 string(32)【墊付回補結(jié)果】 SUCCESS 回補成功
FAILED 回補失敗,出款方賬戶余額不足時發(fā)生
PROCESSING 處理中 - success_time 選填 string(64)【墊付回補完成時間】 墊付回補完成的時間,遵循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秒。
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 | 商戶號不存在 | 請檢查商戶號是否正確 |
403 | NO_AUTH | 沒有墊付回補權(quán)限 | 此狀態(tài)代表墊付退款回補失敗,請檢查是否有墊付回補這筆退款單的權(quán)限 |
403 | NOT_ENOUGH | 余額不足 | 此狀態(tài)代表退款申請失敗,商戶可根據(jù)具體的錯誤提示做相應(yīng)的處理 |
403 | REQUEST_BLOCKED | 請求受阻 | 此狀態(tài)代表退款申請失敗,商戶可根據(jù)具體的錯誤提示做相應(yīng)的處理 |
404 | RESOURCE_NOT_EXISTS | 退款單不存在 | 請檢查退款單號是否有誤以及訂單狀態(tài)是否正確,如:未支付、已支付未退款 |
500 | SYSTEM_ERROR | 接口返回錯誤 | 請不要更換商戶退款單號,請使用相同參數(shù)再次調(diào)用API |