关闭订单

更新时间:2024.12.02

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

注: 订单生成后不能被立即关闭,需在订单生成的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,可使用小程序内部单号。要求此参数由数字、大小写字母_-|*@组成。

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/f2fminiprogram/orderinfo/close?access_token=ACCESS_TOKEN \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_request_no" : "12345678901234567890"
8  }'

应答参数

200 OK

errcode 必填 int64

【错误码】
成功时为0,其它错误码含义详见下方错误码列表


errmsg 必填 string(128)

【错误信息】
错误原因的简要描述

应答示例

204 No Content

1{
2  "errcode":0,
3  "errmsg":"ok"
4}

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

200

269215758

请使用相同参数稍后重新调用

请使用相同参数稍后重新调用

200

269215744

参数错误

根据错误提示,传入正确参数

200

269215753

该订单不存在

根据提示,请检查订单是否正确

200

269215763

该订单已完成支付,无法关闭

订单已完成支付,无法关闭

200

269215764

只能关闭创建满5分钟,不超过24小时的订单

请确认订单支付符合条件关闭

200

269215765

本订单不支持关闭

请确认订单支付符合条件关闭

200

269215766

付款方支付中,请稍后重试

付款方支付中,请稍后重试

 

 

反馈
咨询
目录
置顶