最新更新時(shí)間:2020.1.08 版本說(shuō)明
支付交易返回失敗或支付系統(tǒng)超時(shí),調(diào)用該接口撤銷(xiāo)交易。如果此訂單用戶(hù)支付失敗,微信支付系統(tǒng)會(huì)將此訂單關(guān)閉;如果用戶(hù)支付成功,微信支付系統(tǒng)會(huì)將此訂單資金退還給用戶(hù)。
● 7天以?xún)?nèi)的交易單可調(diào)用撤銷(xiāo),其他正常支付的單如需實(shí)現(xiàn)相同功能請(qǐng)調(diào)用申請(qǐng)退款A(yù)PI。提交支付交易后調(diào)用【查詢(xún)訂單API】,沒(méi)有明確的支付結(jié)果再調(diào)用【撤銷(xiāo)訂單API】。
● 調(diào)用支付接口后請(qǐng)勿立即調(diào)用撤銷(xiāo)訂單API,建議支付后至少15s后再調(diào)用撤銷(xiāo)訂單接口。
適用對(duì)象:直連模式機(jī)構(gòu)模式
請(qǐng)求URL: https://api.mch.weixin.qq.com/hk/v3/transactions/id/{transaction_id}/reverse
或
https://api.mch.weixin.qq.com/hk/v3/transactions/out-trade-no/{out_trade_no}/reverse
請(qǐng)求方式: POST
接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3/wei-xin-zhi-fu-api-v3-jie-kou-gui-fan
頻率限制:150qps
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類(lèi)型 | 必填 | 描述 |
---|---|---|---|---|
商戶(hù)號(hào) | mchid | string(32) | 是 | body 微信支付分配的商戶(hù)號(hào) 注意:僅適用于直連模式 示例值:1900000109 |
機(jī)構(gòu)商戶(hù)號(hào) | sp_mchid | string(32) | 是 | body微信支付分配給機(jī)構(gòu)的商戶(hù)號(hào) 注意:僅適用于機(jī)構(gòu)模式 示例值:1900000100 |
子商戶(hù)號(hào) | sub_mchid | string(32) | 是 | body 微信支付分配子商戶(hù)的商戶(hù)號(hào) 注意:僅適用于機(jī)構(gòu)模式 示例值:1900000109 |
微信訂單號(hào) | transaction_id | string(32) | 二選一 | path 原支付交易對(duì)應(yīng)的微信訂單號(hào) 示例值:1217752501201407033233368018 |
商戶(hù)訂單號(hào) | out_trade_no | string(32) | path 原支付交易對(duì)應(yīng)的訂單號(hào) 示例值:1217752501201407033233368018 |
{
"sp_mchid": "10000100",
"sub_mchid": "20000100"
}
無(wú)數(shù)據(jù)(HTTP狀態(tài)碼為204)
參數(shù)名 | 變量 | 類(lèi)型 | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | code | string(32) | 是 | 錯(cuò)誤碼,枚舉值見(jiàn)錯(cuò)誤碼列表 示例值:INVALID_REQUEST |
返回信息 | message | string(256) | 是 | 返回信息,如非空,為錯(cuò)誤原因 示例值:參數(shù)格式校驗(yàn)錯(cuò)誤 |
+ 詳細(xì)的錯(cuò)誤描述 | detail | object | 否 | 當(dāng)code為PARAM_ERROR時(shí)返回,詳細(xì)說(shuō)明見(jiàn)下 |
{
"code":"INVALID_REQUEST",
"message":"參數(shù)格式校驗(yàn)錯(cuò)誤",
"detail":{
"field":"#/properties/payer",
"value":"1346177081915535577",
"issue":"與ALLOF schema不符",
"location":"body"
}
}
錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|
SYSTEMERROR | 接口返回錯(cuò)誤 | 請(qǐng)立即調(diào)用被掃訂單結(jié)果查詢(xún)API,查詢(xún)當(dāng)前訂單狀態(tài),并根據(jù)訂單的狀態(tài)決定下一步的操作。 |
INVALID_TRANSACTIONID | 無(wú)效transaction_id | 參數(shù)錯(cuò)誤,請(qǐng)重新檢查 |
PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)接口返回的詳細(xì)信息檢查您的程序 |
REVERSE_EXPIRE | 訂單無(wú)法撤銷(xiāo) | 請(qǐng)檢查需要撤銷(xiāo)的訂單是否超過(guò)可撤銷(xiāo)有效期 |
INVALID_REQUEST | 無(wú)效請(qǐng)求 | 請(qǐng)檢查商戶(hù)權(quán)限是否異常、重復(fù)請(qǐng)求支付、證書(shū)錯(cuò)誤、頻率限制等 |
TRADE_ERROR | 訂單錯(cuò)誤 | 請(qǐng)檢查用戶(hù)賬號(hào)是否異常、被風(fēng)控、是否符合規(guī)則限制等 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證