撤销订单

更新时间: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个字符内、可包含字母;更换授权码必须要换新的商户订单号 其他说明见商户订单号
示例值:1217752501201407033233368018

子商户号

sub_mchid

string[1,32]

Body 服务商模式必填,微信支付分配的子商户号
注意:仅适用于机构模式
示例值:10000097

请求示例

场景一:直连模式

1POST
2https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/out-trade-no/1217752501201407033233368018/reverse

场景二:服务商模式/机构模式

1POST
2https://apihk.mch.weixin.qq.com/v3/global/papay/transactions/out-trade-no/1217752501201407033233368018/reverse
3{
4  "sub_mchid": "20000100"
5}

 

3. 返回参数

处理成功,应答无内容

返回示例

1204
2处理成功,应答无内容


4. 错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误 

请检查参数格式是否符合协议规范

404

NOT_FOUND

交易订单号不存在

建议确认订单号和商户号正确之后再查询

400

ORDER_PAID

订单已支付

不可关闭,如需退款,请调用退款接口

500

SYSTEM_ERROR

系统错误

请重试请求

400

ORDER_CLOSED

订单已关闭

订单已关闭,无需再次请求

 

 

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2025 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global

Contact Us

Customer Service Tel

+86 571 95017

9:00-18:00 Monday-Friday GMT+8

Business Development

wxpayglobal@tencent.com

Developer Support

wepayTS@tencent.com

Wechat Pay Global

About Tenpay
Powered By Tencent & Tenpay Copyright© 2005-2025 Tenpay All Rights Reserved.