商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
平台收付通(商户进件)
平台收付通(普通支付)
平台收付通(合单支付)
平台收付通(分账)
平台收付通(补差)
平台收付通(退款)
平台收付通(余额查询)
平台收付通(商户提现)
平台收付通(注销申请)
平台收付通(注销后提现)
平台收付通(跨境付款)
平台收付通(下载账单)
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
商户违规通知回调
其他能力
图片上传
视频上传
微信支付平台证书

合单关闭订单API

最新更新时间:2022.05.18 版本说明


合单支付订单只能使用此合单关单api完成关单。

注意:

• 合单支付关单接口不支持关闭部分子单, 关单的主单商户号、单号、子单个数、子单商户号、子单单号必须与下单时完全一致。

接口说明

适用对象:服务商 电商平台

请求URL:https://api.mch.weixin.qq.com/v3/combine-transactions/out-trade-no/{combine_out_trade_no}/close

请求方式:POST


path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
合单商户appid combine_appid string[1,32] body 合单发起方的appid。
示例值:wxd678efh567hg6787
合单商户订单号 combine_out_trade_no string[1,32] path 合单支付总订单号,要求32个字符内,只能是数字、大小写字母_-|*@ ,且在同一个商户号下唯一。
示例值:P20150806125346
+子单信息 sub_orders array body 最多支持子单条数:50
参数名 变量 类型[长度限制] 必填 描述
子单商户号 mchid string[1,32] 子单发起方商户号,必须与发起方appid有绑定关系。
示例值:1900000109
子单商户订单号 out_trade_no string[6,32] 商户系统内部订单号,要求32个字符内,只能是数字、大小写字母_-|*@ ,且在同一个商户号下唯一。
示例值:20150806125346
二级商户号 sub_mchid string[1,32] 二级商户商户号,由微信支付生成并下发。
服务商子商户的商户号,被合单方。直连商户不用传二级商户号。
示例值:1900000109
子商户应用ID sub_appid string[1,32] 服务商模式下,sub_mchid对应的sub_appid
示例值:wxd678efh567hg6999

请求示例


{
"combine_appid ":"wxd678efh567hg6787",
 "sub_orders": [
   {
     "mchid": "1900000109",
     "out_trade_no": "20150806125346",
     "sub_mchid": "1230000109"
   }
 ]
}
 
    
{
JAVA示例代码
}
    

返回参数

无数据(Http 状态码为204)

错误码公共错误码

状态码 错误码 描述 解决方案
202 USERPAYING 用户支付中,需要输入密码 等待5秒,然后调用被扫订单结果查询API,查询当前订单的不同状态,决定下一步的操作
400 INVALID_REQUEST 输入的请求非法,请求关单的子单信息与下单时的子单信息不一致 请检查关单传入的子单信息与下单时传入的子单信息或子单数量是否一致
ORDER_CLOSED 订单已关闭 当前订单已关闭,请重新下单
PARAM_ERROR 参数错误 请根据接口返回的详细信息检查请求参数
MCH_NOT_EXISTS 商户号不存在 请检查商户号是否正确
INVALID_REQUEST 无效请求 请根据接口返回的详细信息检查
APPID_MCHID_NOT_MATCH appid和mch_id不匹配 请确认appid和mch_id是否匹配
401 SIGN_ERROR 签名错误 请检查签名参数和方法是否都符合签名算法要求
403 NOTENOUGH 余额不足 用户账号余额不足,请用户充值或更换支付卡后再支付
TRADE_ERROR 交易错误 因业务原因交易失败,请查看接口返回的详细信息
RULELIMIT 业务规则限制 因业务规则限制请求频率,请查看接口返回的详细信息
NOAUTH 商户无权限 请商户前往申请此接口相关权限
OUT_TRADE_NO_USED 商户订单号重复 请核实商户订单号是否重复提交
ACCOUNTERROR 账号异常 用户账号异常,无需更多操作
404 ORDERNOTEXIST 订单不存在 请检查订单是否发起过交易
429 FREQUENCY_LIMITED 频率超限 请降低请求接口频率
500 SYSTEMERROR 系统错误 系统异常,请用相同参数重新调用
OPENID_MISMATCH openid和appid不匹配 请确认openid和appid是否匹配
INVALID_TRANSACTIONID 订单号非法 请检查微信支付订单号是否正确
BANKERROR 银行系统异常 银行系统异常,请用相同参数重新调用


技术咨询

文档反馈