微信支付-融合錢包開發(fā)者文檔

返回上一層融合錢包 / 付款碼支付 / 撤銷訂單API

撤銷訂單

最新更新時間：2020.1.08 版本說明

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

注意：

● 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)用撤銷訂單接口。

接口說明

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

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

請求方式: POST

接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3

頻率限制:150qps

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

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

請求參數(shù)

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

請求示例：

JSON

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

    
｛
JAVA示例代碼
｝

返回參數(shù)

正常返回

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

異常返回

參數(shù)名

變量

類型

必填

描述

返回狀態(tài)碼

code

string(32)

是

錯誤碼，枚舉值見錯誤碼列表
示例值：INVALID_REQUEST

返回信息

message

string(256)

是

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

+ 詳細(xì)的錯誤描述

detail

object

否

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

參數(shù)名	變量	類型	必填	描述
指示錯誤參數(shù)的位置	field	string(256)	是	當(dāng)錯誤參數(shù)位于請求body的JSON時，填寫指向參數(shù)的JSON Pointer；當(dāng)錯誤參數(shù)位于請求的url或者querystring時，填寫參數(shù)的變量名示例值：#/properties/payer
錯誤參數(shù)的值	value	string(256)	是	錯誤參數(shù)的值示例值：1346177081915535577
具體錯誤原因	issue	string(256)	是	具體錯誤原因示例值：與ALLOF schema不符
錯誤參數(shù)的位置	location	string(256)	否	body：錯誤參數(shù)位于請求body的JSON中 url：錯誤參數(shù)位于請求url中 query：錯誤參數(shù)位于請求的querystring中示例值：body

返回示例：

異常示例

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

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

錯誤碼

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

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

付款碼支付

撤銷訂單

注意：

接口說明

請求參數(shù)

請求示例：

返回參數(shù)

正常返回

異常返回

返回示例：

錯誤碼

版本說明