API字典 / 分賬（發(fā)起交易） / 撤銷訂單API

撤銷訂單

最新更新時(shí)間：2023.04.21 版本說明

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

注意：

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

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

1. 接口說明

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

請求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

請求方式：POST

頻率限制:150qps

Path指該參數(shù)為路徑參數(shù)

Query指該參數(shù)為URL參數(shù)

Body指該參數(shù)需在請求JSON傳參

2. 請求參數(shù)

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

請求示例

機(jī)構(gòu)模式直連模式


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


{
    "mchid": "10000100"
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回參數(shù)

正常返回

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

異常返回

參數(shù)名

變量

類型[長度限制]

必填

描述

返回狀態(tài)碼

code

string[1, 32]

是

錯(cuò)誤碼，枚舉值見錯(cuò)誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string[1, 256]

是

返回信息，如非空，為錯(cuò)誤原因
示例值：參數(shù)格式校驗(yàn)錯(cuò)誤

詳細(xì)的錯(cuò)誤描述

detail

object

否

當(dāng)code為PARAM_ERROR時(shí)返回，詳細(xì)說明見下

參數(shù)名	變量	類型[長度限制]	必填	描述
指示錯(cuò)誤參數(shù)的位置	field	string[1, 256]	是	當(dāng)錯(cuò)誤參數(shù)位于請求body的JSON時(shí)，填寫指向參數(shù)的JSON Pointer 當(dāng)錯(cuò)誤參數(shù)位于請求的url或者querystring時(shí)，填寫參數(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ù)位于請求body的JSON中 url：錯(cuò)誤參數(shù)位于請求url中 query：錯(cuò)誤參數(shù)位于請求的querystring中示例值：body

收起

返回示例

正常示例異常示例


204
（無內(nèi)容返回）


{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "與ALLOF schema不符",
		"location": "body"
	}
}

4. 錯(cuò)誤碼

錯(cuò)誤碼	描述	解決方案
SYSTEM_ERROR	接口返回錯(cuò)誤	請立即調(diào)用被掃訂單結(jié)果查詢API，查詢當(dāng)前訂單狀態(tài)，并根據(jù)訂單的狀態(tài)決定下一步的操作。
BIZERR_NEED_RETRY	無效transaction_id	參數(shù)錯(cuò)誤，請重新檢查
PARAM_ERROR	參數(shù)錯(cuò)誤	請根據(jù)接口返回的詳細(xì)信息檢查您的程序
REVERSE_EXPIRE	訂單無法撤銷	請檢查需要撤銷的訂單是否超過可撤銷有效期
INVALID_REQUEST	無效請求	請檢查商戶權(quán)限是否異常、重復(fù)請求支付、證書錯(cuò)誤、頻率限制等
TRADE_ERROR	訂單錯(cuò)誤	請檢查用戶賬號(hào)是否異常、被風(fēng)控、是否符合規(guī)則限制等

語言

頁面導(dǎo)航

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付產(chǎn)品

資金類產(chǎn)品

其他產(chǎn)品

撤銷訂單

1. 接口說明

2. 請求參數(shù)

請求示例

3. 返回參數(shù)

正常返回

異常返回

返回示例

4. 錯(cuò)誤碼