微信支付-融合钱包开发者文档

返回上一层融合钱包 / Native支付 / 关闭订单API

关闭订单

最新更新时间：2020.1.08 版本说明

以下情况需要调用关单接口：商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。

注意：

● 订单生成后不能马上调用关单接口，最短调用时间间隔为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

接口规则: 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

请求示例：

JSON


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

    
｛
JAVA示例代码
｝

返回参数

正常返回

无数据(HTTP状态码为204)

异常返回

参数名

变量

类型

必填

描述

返回状态码

code

string(32)

是

错误码，枚举值见错误码列表
示例值：INVALID_REQUEST

返回信息

message

string(256)

是

返回信息，如非空，为错误原因
示例值：参数格式校验错误

+ 详细的错误描述

detail

object

否

当code为PARAM_ERROR时返回，详细说明见下

参数名	变量	类型	必填	描述
指示错误参数的位置	field	string(256)	是	当错误参数位于请求body的JSON时，填写指向参数的JSON Pointer；当错误参数位于请求的url或者querystring时，填写参数的变量名示例值：#/properties/payer
错误参数的值	value	string(256)	是	错误参数的值示例值：1346177081915535577
具体错误原因	issue	string(256)	是	具体错误原因示例值：与ALLOF schema不符
错误参数的位置	location	string(256)	否	body：错误参数位于请求body的JSON中 url：错误参数位于请求url中 query：错误参数位于请求的querystring中示例值：body

返回示例：

异常示例

{
"code":"INVALID_REQUEST",
"message":"参数格式校验错误",
"detail":{
    "field":"#/properties/payer",
    "value":"1346177081915535577",
    "issue":"与ALLOF schema不符",
    "location":"body"
   }
}

错误码

错误码	描述	解决方案
ORDERPAID	订单已支付	订单已支付，不能发起关单，请当作已支付的正常交易
SYSTEMERROR	系统错误	系统异常，请重新调用该API
ORDERCLOSED	订单已关闭	订单已关闭，无需继续调用
REQUIRE_POST_METHOD	请使用post方法	请检查请求参数是否通过post方法提交

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

Native支付

关闭订单

注意：

接口说明

请求参数

请求示例：

返回参数

正常返回

异常返回

返回示例：

错误码

版本说明