撤銷(xiāo)訂單
支付交易返回失敗或支付系統(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)訂單接口。
1. 接口說(shuō)明
適用對(duì)象: 直連模式 機(jī)構(gòu)模式
請(qǐng)求URL:https://apihk.mch.weixin.qq.com/v3/global/micropay/transactions/id/{transaction_id}/reverse
或
https://apihk.mch.weixin.qq.com/v3/global/micropay/transactions/out-trade-no/{out_trade_no}/reverse
請(qǐng)求方式:POST
頻率限制:150qps
Path指該參數(shù)為路徑參數(shù)
Query指該參數(shù)為URL參數(shù)
Body指該參數(shù)需在請(qǐng)求JSON傳參
3. 返回參數(shù)
正常返回
無(wú)數(shù)據(jù)(HTTP狀態(tài)碼為204)
異常返回
參數(shù)名 |
變量 |
類(lèi)型[長(zhǎng)度限制] |
必填 |
描述 |
返回狀態(tài)碼 |
code |
string[1, 32] |
是 |
錯(cuò)誤碼,枚舉值見(jiàn)錯(cuò)誤碼列表
示例值:INVALID_REQUEST |
返回信息 |
message |
string[1, 256] |
是 |
返回信息,如非空,為錯(cuò)誤原因
示例值:參數(shù)格式校驗(yàn)錯(cuò)誤 |
詳細(xì)的錯(cuò)誤描述 |
detail |
object |
否 |
當(dāng)code為PARAM_ERROR時(shí)返回,詳細(xì)說(shuō)明見(jiàn)下 |
參數(shù)名 |
變量 |
類(lèi)型[長(zhǎng)度限制] |
必填 |
描述 |
指示錯(cuò)誤參數(shù)的位置 |
field |
string[1, 256] |
是 |
當(dāng)錯(cuò)誤參數(shù)位于請(qǐng)求body的JSON時(shí),填寫(xiě)指向參數(shù)的JSON Pointer
當(dāng)錯(cuò)誤參數(shù)位于請(qǐng)求的url或者querystring時(shí),填寫(xiě)參數(shù)的變量名
示例值:#/properties/payer |
錯(cuò)誤參數(shù)的值 |
value |
string[1, 256] |
是 |
錯(cuò)誤參數(shù)的值
示例值:1346177081915535577 |
具體錯(cuò)誤原因 |
issue |
string[1, 256] |
是 |
具體錯(cuò)誤原因
示例值:與ALLOF schema不符 |
錯(cuò)誤參數(shù)的位置 |
location |
string[1, 256] |
否 |
body:錯(cuò)誤參數(shù)位于請(qǐng)求body的JSON中
url:錯(cuò)誤參數(shù)位于請(qǐng)求url中
query:錯(cuò)誤參數(shù)位于請(qǐng)求的querystring中
示例值:body |
|
返回示例
204
(無(wú)內(nèi)容返回)
{
"code": "INVALID_REQUEST",
"message": "Parameter format verification error",
"detail": {
"field": "#/properties/payer",
"value": "1346177081915535577",
"issue": "與ALLOF schema不符",
"location": "body"
}
}