關(guān)閉訂單API
以下情況需要調(diào)用關(guān)單接口:商戶訂單支付失敗需要生成新單號(hào)重新發(fā)起支付,要對(duì)原訂單號(hào)調(diào)用關(guān)單,避免重復(fù)支付;系統(tǒng)下單后,用戶支付超時(shí),系統(tǒng)退出不再受理,避免用戶繼續(xù),請(qǐng)調(diào)用關(guān)單接口。
? 訂單生成后不能馬上調(diào)用關(guān)單接口,最短調(diào)用時(shí)間間隔為5分鐘。
以下情況需要調(diào)用關(guān)單接口:商戶訂單支付失敗需要生成新單號(hào)重新發(fā)起支付,要對(duì)原訂單號(hào)調(diào)用關(guān)單,避免重復(fù)支付;系統(tǒng)下單后,用戶支付超時(shí),系統(tǒng)退出不再受理,避免用戶繼續(xù),請(qǐng)調(diào)用關(guān)單接口。
? 訂單生成后不能馬上調(diào)用關(guān)單接口,最短調(diào)用時(shí)間間隔為5分鐘。
適用對(duì)象:直連模式機(jī)構(gòu)模式
請(qǐng)求URL:https://apihk.mch.weixin.qq.com/v3/global/transactions/id/{transaction_id}/close
或
https://apihk.mch.weixin.qq.com/v3/global/transactions/out-trade-no/{out_trade_no}/close
請(qǐng)求方式: POST
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付訂單號(hào) | transaction_id | string[1,32] | 二選一 | Path 微信支付訂單號(hào) 示例值:1217752501201407033233368018 |
商戶訂單號(hào) | out_trade_no | string[1,32] | Path 商戶訂單號(hào) 示例值:1217752501201407033233368018 |
|
商戶號(hào) | mchid | string[1,32] | 是 | Body 微信支付分配的商戶號(hào) 注意:僅適用于直連模式 示例值:1900000109 |
子商戶號(hào) | sub_mchid | string[1,32] | 是 | Body 微信支付分配的子商戶號(hào) 注意:僅適用于機(jī)構(gòu)模式 示例值:1900000109 |
機(jī)構(gòu)商戶號(hào) | sp_mchid | string[1,32] | 是 | Body 微信支付分配的機(jī)構(gòu)商戶號(hào) 注意:僅適用于機(jī)構(gòu)模式 示例值:1900000100 |
{
"sp_mchid": "10000100",
"sub_mchid": "20000100"
}
無數(shù)據(jù)(HTTP狀態(tài)碼為204)
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
返回狀態(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ì)說明見下 |
{
"code": "INVALID_REQUEST",
"message": "Parameter format verification error",
"detail": {
"field": "#/properties/payer",
"value": "1346177081915535577",
"issue": "與ALLOF schema不符",
"location": "body"
}
}
錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|
ORDERPAID | 訂單已支付 | 訂單已支付,不能發(fā)起關(guān)單,請(qǐng)當(dāng)作已支付的正常交易 |
SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常,請(qǐng)重新調(diào)用該API |
ORDER_CLOSED | 訂單已關(guān)閉 | 訂單已關(guān)閉,無需繼續(xù)調(diào)用 |
REQUIRE_POST_METHOD | 請(qǐng)使用post方法 | 請(qǐng)檢查請(qǐng)求參數(shù)是否通過post方法提交 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證