关闭订单

更新时间:2024.12.27

一笔订单被创建后,如果小程序希望该笔订单不应该被付款方支付时,可以调用关闭订单接口来关闭订单。若该笔订单已被支付,则接口会返回关闭订单失败。

注: 订单生成后不能被立即关闭,需在订单生成的5分钟后才能发起关闭

# 接口说明

支持商户: 【普通服务商】

请求方式: 【POST】

请求URL: "https://api.weixin.qq.com/wxa/business/f2f/closeorderinfo"

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
    Query 查询参数
  • access_token 必填 string(512)
    【接口调用凭证】
    1、调用接口的凭证,获取方式参见《auth.getAccessToken》文档https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html
    2、HTTPS方式调用时,该参数必填;云调用时无此参数。
    Body 包体参数
  • out_request_no 必填 string(32)
    【请求号】
    1、与创建订单接口中的out_request_no(请求号)参数一致。
    2、请求号为一次支付的唯一幂等ID,可使用小程序内部单号。要求此参数由数字、大小写字母_-|*@组成。

请求示例

POST

# 应答参数

    200OK
  • errcode 必填 int64
    【错误码】
    成功时为0,其它错误码含义详见下方错误码列表
  • errmsg 必填 string(128)
    【错误信息】
    错误原因的简要描述

应答示例

204 No Content

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则 请参阅 接口规则 (opens new window)
401 SIGN_ERROR 验证不通过 请参阅 签名常见问题 (opens new window)
500 SYSTEM_ERROR 系统异常,请稍后重试 请稍后重试

# 业务错误码

状态码 错误码 描述 解决方案
200 269215758 请使用相同参数稍后重新调用 请使用相同参数稍后重新调用
200 269215744 参数错误 根据错误提示,传入正确参数
200 269215753 该订单不存在 根据提示,请检查订单是否正确
200 269215763 该订单已完成支付,无法关闭 订单已完成支付,无法关闭
200 269215764 只能关闭创建满5分钟,不超过24小时的订单 请确认订单支付符合条件关闭
200 269215765 本订单不支持关闭 请确认订单支付符合条件关闭
200 269215766 付款方支付中,请稍后重试 付款方支付中,请稍后重试
反馈
咨询
目录

微信支付文档中心已升级,你当前所查看的是旧文档中心的内容,旧文档中心将于 2025年 3 月 31日 下线,请移步 [新文档中心] 查看相应的内容