撤销订单
更新时间:2025.01.07商户可以通过该接口发起撤销订单。
1. 接口说明
适用对象: 直连模式 机构模式
请求URL:https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/out-trade-no/{out_trade_no}/reverse
请求方式:POST
Path 指该参数为路径参数
Query 指该参数为URL参数
Body 指该参数需在请求JSON传参
2. 请求参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
商户订单号 | out_trade_no | string[1,32] | 是 | Path 商户系统内部的订单号,32个字符内、可包含字母;更换授权码必须要换新的商户订单号 其他说明见商户订单号 |
子商户号 | sub_mchid | string[1,32] | 是 | Body 服务商模式必填,微信支付分配的子商户号 |
请求示例
场景一:直连模式
场景二:服务商模式/机构模式
3. 返回参数
处理成功,应答无内容
返回示例
4. 错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请检查参数格式是否符合协议规范 |
404 | NOT_FOUND | 交易订单号不存在 | 建议确认订单号和商户号正确之后再查询 |
400 | ORDER_PAID | 订单已支付 | 不可关闭,如需退款,请调用退款接口 |
500 | SYSTEM_ERROR | 系统错误 | 请重试请求 |
400 | ORDER_CLOSED | 订单已关闭 | 订单已关闭,无需再次请求 |