向个人收银 (C2B 支付)接口列表合单支付-订单关闭合单支付-订单关闭
业务方调用此接口将订单进行关闭。
以下四种订单中,可以发起订单关闭请求
BEFORE:预下单成功
INIT:初始化成功
PAYING:支付中
WAIT_CONFIRM: 待支付
接口说明
用途:合单支付-订单关闭请求方式:posthttps://p.wecard.tencent.com/cloudpay/v1/pay/combine_close_order复制
请求参数
RequestBody 包体CombineOrderId必填string母单ID
最小长度:6 最大长度:60Reason选填string关单原因,微信直连通道免密支付取消订单时需传递
请求示例{
"CombineOrderId": "OUT2022111900000004"
}
返回参数
Response200 OKResponse必填object子属性RequestId必填stringResult选填object子属性OutOrderId必填string外部订单号,即业务系统侧订单
OrderStatus必填string订单状态,枚举值
ErrCode必填stringErrMessage必填string返回示例{
"Response": {
"RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
"Result": {
"OutOrderId": "OUT2022111900000004",
"OrderStatus": "CLOSED"
},
"ErrCode": "SUCCESS",
"ErrMessage": "成功"
}
}
ErrCode 码表
错误代码描述解决方案SUCCESS请求成功需根据 Result 中 OrderStatus 字段为 CLOSED 判断为关单成功ORDER.RECORD_NOT_EXIST订单不存在需要关闭的订单不存在,请检查订单号是否正确ORDER.OPERATE_IS_PROCESSING订单存在并发操作当前支付订单同时存在别的请求操作(如退款、关单等),请稍后重试FailedOperation.SystemError系统未知异常系统未知异常,请稍后重试ORDER.INVALID_PARAMETER参数有误请根据返回描述修正请求参数ORDER.CURRENT_CANNOT_CLOSE无法关单请确认支付订单状态是否允许关单