关闭订单

关闭一笔未付款的订单。关闭后付款人不能再用原来的付款页付款。

请求地址

https://z.weixiao.cc/close，POST 表单。

请求参数

参数	类型	必填	说明
`pid`	String	必填	商户号，「API信息」里的商户号
`trade_no`	String	否	站长单号
`out_trade_no`	String	否	商户单号，下单时传的商户单号
`sign`	String	必填	签名
`sign_type`	String	否	签名类型

trade_no：与 out_trade_no 至少传一个，都传时以它为准
sign：见「V1（MD5签名）」「V2（RSA签名）」
sign_type：MD5 或 RSA，不传按 MD5；签名方式为「RSA签名」的商户必须传 RSA

请求示例

curl -X POST 'https://z.weixiao.cc/close' \
  --data-urlencode 'pid=1001' \
  --data-urlencode 'out_trade_no=20260927123456' \
  --data-urlencode 'sign=你算出的签名' \
  --data-urlencode 'sign_type=MD5'

返回参数

参数	类型	说明
`code`	Int	返回码，`1` 为关闭成功
`msg`	String	返回信息
`trade_no`	String	站长单号，关闭成功时返回

返回示例

{
  "code": 1,
  "msg": "订单关闭成功",
  "trade_no": "2026092712000012345"
}

失败示例

{"code":-1,"msg":"该订单已支付，无法关闭"}

返回信息	说明
订单号不能为空	`trade_no` 和 `out_trade_no` 都没传
订单不存在
该订单已支付，无法关闭	订单已经付款
该订单已退款，无法关闭
该订单已冻结，无法关闭
该订单状态不支持关闭
当前支付通道不支持关闭订单	这笔订单所用的支付通道没有关单功能
上游未确认关闭订单	支付通道没有确认关闭，订单保持未付款
上游支付请求超时，订单处理中	结果还不确定，订单保持未付款
上游支付结果未知，订单处理中	同上
关单结果未知，订单处理中	同上
订单状态已变化，请稍后重试	关闭过程中订单状态变了，稍后用「查询订单」确认
支付通道返回的原因	支付通道拒绝关闭时，原样返回通道给出的原因

「该订单已支付，无法关闭」：订单已经付款；关闭时才发现已付款的，订单按已付款处理并发送支付结果通知
「上游支付请求超时，订单处理中」：结果还不确定，订单保持未付款，稍后用「查询订单」确认

注意事项

只有未付款的订单能关闭；已经关闭的订单再关一次，同样返回「订单关闭成功」。
平台先请支付通道关闭订单，通道确认后才关闭；关闭成功后订单状态为 2（已关闭）。
返回「……订单处理中」时订单仍是未付款状态，付款人此时付款照常入账，结果以「查询订单」和「支付结果通知」为准。