最新更新时间: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 |
{
"combine_appid ":"wxd678efh567hg6787",
"sub_orders": [
{
"mchid": "1900000109",
"out_trade_no": "20150806125346",
"sub_mchid": "1230000109"
}
]
}
无数据(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 | 银行系统异常 | 银行系统异常,请用相同参数重新调用 |