最新更新時間:2020.1.08 版本說明
以下情況需要調用關單接口:商戶訂單支付失敗需要生成新單號重新發(fā)起支付,要對原訂單號調用關單,避免重復支付;系統下單后,用戶支付超時,系統退出不再受理,避免用戶繼續(xù),請調用關單接口。
● 訂單生成后不能馬上調用關單接口,最短調用時間間隔為5分鐘。
適用對象:直連模式機構模式
請求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 指該參數需在請求URL傳參
query 指該參數需在請求JSON傳參
參數名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
微信支付訂單號 | transaction_id | string(32) | 二選一 | path 微信支付訂單號 示例值:1217752501201407033233368018 |
商戶訂單號 | out_trade_no | string(32) | path 商戶訂單號 示例值:1217752501201407033233368018 |
|
商戶號 | mchid | string(32) | 是 | query 微信支付分配的商戶號 注意:僅適用于直連模式 示例值:1900000109 |
子商戶號 | sub_mchid | string(32) | 是 | query 微信支付分配的子商戶號 注意:僅適用于機構模式 示例值:1900000109 |
機構商戶號 | sp_mchid | string(32) | 是 | query 微信支付分配的機構商戶號 注意:僅適用于機構模式 示例值:1900000100 |
{
"sp_mchid": "10000100",
"sub_mchid": "20000100"
}
無數據(HTTP狀態(tài)碼為204)
參數名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
返回狀態(tài)碼 | code | string(32) | 是 | 錯誤碼,枚舉值見錯誤碼列表 示例值:INVALID_REQUEST |
返回信息 | message | string(256) | 是 | 返回信息,如非空,為錯誤原因 示例值:參數格式校驗錯誤 |
+ 詳細的錯誤描述 | detail | object | 否 | 當code為PARAM_ERROR時返回,詳細說明見下 |
{
"code":"INVALID_REQUEST",
"message":"參數格式校驗錯誤",
"detail":{
"field":"#/properties/payer",
"value":"1346177081915535577",
"issue":"與ALLOF schema不符",
"location":"body"
}
}
錯誤碼 | 描述 | 解決方案 |
---|---|---|
ORDERPAID | 訂單已支付 | 訂單已支付,不能發(fā)起關單,請當作已支付的正常交易 |
SYSTEMERROR | 系統錯誤 | 系統異常,請重新調用該API |
ORDERCLOSED | 訂單已關閉 | 訂單已關閉,無需繼續(xù)調用 |
REQUIRE_POST_METHOD | 請使用post方法 | 請檢查請求參數是否通過post方法提交 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證