未支付状态的订单，合单发起方商户可在无需支付时调用此接口关闭订单。常见关单情况包括：
用户在商户系统提交取消订单请求，商户需执行关单操作。
订单超时未支付（超出商户系统设定的可支付时间或下单时的time_expire支付截止时间），商户需进行关单处理。
注意
此接口只能整单关闭，不支持关闭部分子单，关单的合单发起方商户号、合单商户订单号、子单个数、子单商户号、子单商户订单号必须与下单时传入的完全一致。
接口说明支持商户：【普通商户】
请求方式：【POST】/v3/combine-transactions/out-trade-no/{combine_out_trade_no}/close
请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点
【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ，指引点击查看
请求参数Header HTTP头参数
Authorization 必填 string
请参考签名认证生成认证信息
Accept 必填 string
请设置为application/json
Content-Type 必填 string
请设置为application/json
path 路径参数
combine_out_trade_no 必填 string
【合单商户订单号】合单下单时传入的合单商户订单号。
body 包体参数
combine_appid 必填 string(32)
【合单商户公众账号ID】合单下单时传入的combine_appid。
sub_orders 必填 array[ReqCloseSubOrder]
【子单信息列表】合单下单时传入的子单信息列表。
属性 mchid 必填 string
【子单商户号】合单下单时传入的子单商户号。
out_trade_no 必填 string
【子单商户订单号】合单下单时传入的子单商户订单号。
请求示例
POST
1curl -X POST \
2 https://api.mch.weixin.qq.com/v3/combine-transactions/out-trade-no/1217752501201407033233368018/close \
3 -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4 -H "Accept: application/json" \
5 -H "Content-Type: application/json" \
6 -d '{
7 "combine_appid" : "wxd678efh567hg6787",
8 "sub_orders" : [
9 {
10 "mchid" : "1900000109",
11 "out_trade_no" : "20150806125346"
12 },
13 {
14 "mchid" : "1900000179",
15 "out_trade_no" : "20150806124561"
16 }
17 ]
18 }'
19应答参数无应答包体
应答示例
204 No Content
1'无应答包体'
错误码公共错误码状态码
错误码
描述
解决方案
400
PARAM_ERROR
参数错误
请根据错误提示正确传入参数
400
INVALID_REQUEST
HTTP 请求不符合微信支付 APIv3 接口规则
请参阅接口规则检查传入的参数
401
SIGN_ERROR
验证不通过
请参阅签名常见问题排查
500
SYSTEM_ERROR
系统异常，请稍后重试
请稍后重试
业务错误码状态码
错误码
描述
解决方案
400
APPID_MCHID_NOT_MATCH
AppID和mch_id不匹配
请确认AppID和mch_id是否匹配，参考：查询商户号绑定的APPID账号
400
INVALID_REQUEST
输入的请求非法，请求关单的子单信息与下单时的子单信息不一致
请检查关单传入的子单信息与下单时传入的子单信息或子单数量是否一致
400
INVALID_REQUEST
无效请求
请根据接口返回的详细信息检查
400
MCH_NOT_EXISTS
商户号不存在
请检查商户号是否正确，商户号获取方式请参考：普通商户模式开发必要参数说明
400
ORDER_CLOSED
订单已关闭
当前订单已关闭，请重新下单
401
SIGN_ERROR
签名错误
请检查签名参数和方法是否都符合签名算法要求，参考：如何生成签名
403
NOAUTH
商户无权限
请商户联系对接运营申请此接口相关权限，参考：权限申请
404
ORDERNOTEXIST
订单不存在
请检查订单是否发起过交易
429
FREQUENCY_LIMITED
频率超限
请降低请求接口频率
500
SYSTEMERROR
系统错误
系统异常，请用相同参数重新调用