撤销订单

更新时间：2026.05.21

支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，网联会将此订单关闭；如果用户支付成功，网联会将此订单资金退还给用户。

注意：7天以内的交易单可调用撤销，其他正常支付的单如需实现相同功能请调用申请退款API。

提交支付交易后调用【查询订单API】，没有明确的支付结果再调用【撤销订单API】。调用支付接口后请勿立即调用撤销订单API，建议支付后至少15s 后再调用撤销订单接口。

字段名	变量名	是否必填	类型	示例值	描述
公众账号 ID	`appid`	是	`String(32)`	`wx8888888888888888`	微信分配的公众账号 ID。
商户号	`mch_id`	是	`String(32)`	`1900000109`	微信支付分配的商户号。
子商户公众账号 ID	`sub_appid`	否	`String(32)`	`wx8888888888888888`	微信分配的子商户公众账号 ID。
子商户号	`sub_mch_id`	是	`String(32)`	`1900000109`	微信支付分配的子商户号。
渠道商商户号	`channel_id`	是	`String(32)`	`190000001`	微信支付分配给收单服务商 ID。
商户订单号	`out_trade_no`	是	`String(32)`	`12121217752501201407033233368010`	原交易的商户订单号，32 个字符以内、可包含字母、数字、下划线；需保证在商户端不重复。
网联 IDC 标识	`idc_flag`	是	`String(2)`	`10`	交易发往的网联条码支付 IDC 标识，具体规则见 4.8 网联条码支付 IDC 标识。
随机字符串	`nonce_str`	是	`String(32)`	`5K8264ILTKCH16CQ2502SI8ZNMTM67VS`	随机字符串，不长于 32 位。推荐随机数生成算法。
签名	`sign`	是	`String(512)`	`C380BEC2BFD727A4B6845133519F3AD6`	签名。

字段名	变量名	是否必填	类型	示例值	描述
返回状态码	`return_code`	是	`String(16)`	`SUCCESS`	`SUCCESS/FAIL`。此字段是通信标识，非交易标识，交易是否成功需要查看 `result_code` 来判断。
返回信息	`return_msg`	否	`String(128)`	`签名失败`	返回信息，如非空，为错误原因。签名失败。参数格式校验错误。

以下字段在 return_code 为 SUCCESS 的时候有返回：

名称	描述	原因	解决方案
`SYSTEMERROR`	接口返回错误	系统超时	请立即调用被扫订单结果查询 API，查询当前订单状态，并根据订单的状态决定下一步的操作
`INVALID_TRANSACTIONID`	无效 transaction_id	请求参数未按指引进行填写	参数错误，请重新检查
`PARAM_ERROR`	参数错误	请求参数未按指引进行填写	请根据接口返回的详细信息检查您的程序
`REQUIRE_POST_METHOD`	请使用 post 方法	未使用 post 传递参数	请检查请求参数是否通过 post 方法提交
`SIGNERROR`	签名错误	参数签名结果不正确	请检查签名参数和方法是否都符合签名算法要求
`REVERSE_EXPIRE`	订单无法撤销	订单有 7 天的撤销有效期，过期将不能撤销	请检查需要撤销的订单是否超过可撤销有效期
`INVALID_REQUEST`	无效请求	商户系统异常导致	请检查商户权限是否异常、重复请求支付、证书错误、频率限制等
`TRADE_ERROR`	订单错误	业务错误导致交易失败	请检查用户账号是否异常、被风控、是否符合规则限制等

文档是否有帮助