微信支付-錢(qián)包融合開(kāi)發(fā)者文檔

撤銷訂單

最新更新時(shí)間：2020.1.08 版本說(shuō)明

支付交易返回失敗或支付系統(tǒng)超時(shí)，調(diào)用該接口撤銷交易。如果此訂單用戶支付失敗，微信支付系統(tǒng)會(huì)將此訂單關(guān)閉；如果用戶支付成功，微信支付系統(tǒng)會(huì)將此訂單資金退還給用戶。

注意：

● 7天以內(nèi)的交易單可調(diào)用撤銷，其他正常支付的單如需實(shí)現(xiàn)相同功能請(qǐng)調(diào)用申請(qǐng)退款A(yù)PI。提交支付交易后調(diào)用【查詢訂單API】，沒(méi)有明確的支付結(jié)果再調(diào)用【撤銷訂單API】。

● 調(diào)用支付接口后請(qǐng)勿立即調(diào)用撤銷訂單API，建議支付后至少15s后再調(diào)用撤銷訂單接口。

接口說(shuō)明

適用對(duì)象:直連模式機(jī)構(gòu)模式

請(qǐng)求URL: https://api.mch.weixin.qq.com/hk/v3/transactions/transaction_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

頻率限制:150qps

path 指該參數(shù)需在請(qǐng)求URL傳參

query 指該參數(shù)需在請(qǐng)求JSON傳參

請(qǐng)求參數(shù)

參數(shù)名	變量	類型	必填	描述
商戶號(hào)	mchid	是	string(32)	query 微信支付分配的商戶號(hào) 注意：僅適用于直連模式示例值：1900000109
機(jī)構(gòu)商戶號(hào)	sp_mchid	是	string(32)	query微信支付分配給機(jī)構(gòu)的商戶號(hào) 注意：僅適用于機(jī)構(gòu)模式示例值：1900000100
子商戶號(hào)	sub_mchid	是	string(32)	query 微信支付分配子商戶的商戶號(hào) 注意：僅適用于機(jī)構(gòu)模式示例值：1900000109
微信訂單號(hào)	transaction_id	二選一	string(32)	path 原支付交易對(duì)應(yīng)的微信訂單號(hào) 示例值：1217752501201407033233368018
商戶訂單號(hào)	out_trade_no	二選一	string(32)	path 原支付交易對(duì)應(yīng)的訂單號(hào) 示例值：1217752501201407033233368018

請(qǐng)求示例：

JSON

{
    "sp_mchid": "10000100",
    "sub_mchid": "20000100"
}

    
｛
JAVA示例代碼
｝

返回參數(shù)

正常返回

無(wú)數(shù)據(jù)(HTTP狀態(tài)碼為204)

異常返回

參數(shù)名

變量

類型

必填

描述

返回狀態(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)下

參數(shù)名	變量	類型	必填	描述
指示錯(cuò)誤參數(shù)的位置	field	string(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(256)	是	錯(cuò)誤參數(shù)的值示例值：1346177081915535577
具體錯(cuò)誤原因	issue	string(256)	是	具體錯(cuò)誤原因示例值：與ALLOF schema不符
錯(cuò)誤參數(shù)的位置	location	string(256)	否	body：錯(cuò)誤參數(shù)位于請(qǐng)求body的JSON中 url：錯(cuò)誤參數(shù)位于請(qǐng)求url中 query：錯(cuò)誤參數(shù)位于請(qǐng)求的querystring中示例值：body

返回示例：

異常示例

{
"code":"INVALID_REQUEST",
"message":"參數(shù)格式校驗(yàn)錯(cuò)誤",
"detail":{
    "field":"#/properties/payer",
    "value":"1346177081915535577",
    "issue":"與ALLOF schema不符",
    "location":"body"
   }
}

{
"code":"INVALID_REQUEST",
"message":"參數(shù)格式校驗(yàn)錯(cuò)誤",
"detail":{
    "field":"#/properties/payer",
    "value":"1346177081915535577",
    "issue":"與ALLOF schema不符",
    "location":"body"
   }
}

錯(cuò)誤碼

錯(cuò)誤碼	描述	解決方案
SYSTEMERROR	接口返回錯(cuò)誤	請(qǐng)立即調(diào)用被掃訂單結(jié)果查詢API，查詢當(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ú)法撤銷	請(qǐng)檢查需要撤銷的訂單是否超過(guò)可撤銷有效期
INVALID_REQUEST	無(wú)效請(qǐng)求	請(qǐng)檢查商戶權(quán)限是否異常、重復(fù)請(qǐng)求支付、證書(shū)錯(cuò)誤、頻率限制等
TRADE_ERROR	訂單錯(cuò)誤	請(qǐng)檢查用戶賬號(hào)是否異常、被風(fēng)控、是否符合規(guī)則限制等

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

微信支付商戶平臺(tái)

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

付款碼支付

撤銷訂單

注意：

接口說(shuō)明

請(qǐng)求參數(shù)

請(qǐng)求示例：

返回參數(shù)

正常返回

異常返回

返回示例：

錯(cuò)誤碼

版本說(shuō)明