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

返回上一層融合錢包 / 小程序支付 / 關(guān)閉訂單API

關(guān)閉訂單

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

以下情況需要調(diào)用關(guān)單接口：商戶訂單支付失敗需要生成新單號(hào)重新發(fā)起支付，要對原訂單號(hào)調(diào)用關(guān)單，避免重復(fù)支付；系統(tǒng)下單后，用戶支付超時(shí)，系統(tǒng)退出不再受理，避免用戶繼續(xù)，請調(diào)用關(guān)單接口。

注意：

● 訂單生成后不能馬上調(diào)用關(guān)單接口，最短調(diào)用時(shí)間間隔為5分鐘。

接口說明

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

請求URL: https://api.mch.weixin.qq.com/hk/v3/transactions/{transaction_id}/close
或
https://api.mch.weixin.qq.com/hk/v3/transactions/out-trade-no/{out_trade_no}/close

請求方式: POST

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

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

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

請求參數(shù)

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

請求示例：

JSON


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

    
｛
JAVA示例代碼
｝

返回參數(shù)

正常返回

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

異常返回

參數(shù)名

變量

類型

必填

描述

返回狀態(tài)碼

code

string(32)

是

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

返回信息

message

string(256)

是

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

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

detail

object

否

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

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

返回示例：

異常示例

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

錯(cuò)誤碼

錯(cuò)誤碼	描述	解決方案
ORDERPAID	訂單已支付	訂單已支付，不能發(fā)起關(guān)單，請當(dāng)作已支付的正常交易
SYSTEMERROR	系統(tǒng)錯(cuò)誤	系統(tǒng)異常，請重新調(diào)用該API
ORDERCLOSED	訂單已關(guān)閉	訂單已關(guān)閉，無需繼續(xù)調(diào)用
REQUIRE_POST_METHOD	請使用post方法	請檢查請求參數(shù)是否通過post方法提交

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

小程序支付

關(guān)閉訂單

注意：

接口說明

請求參數(shù)

請求示例：

返回參數(shù)

正常返回

異常返回

返回示例：

錯(cuò)誤碼

版本說明