查询订单

按站长单号或商户单号查询一笔订单的当前状态。

请求地址

https://z.weixiao.cc/query，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/query' \
  --data-urlencode 'pid=1001' \
  --data-urlencode 'out_trade_no=20260927123456' \
  --data-urlencode 'sign=d806f7ec0621fc96042accb24c02db81' \
  --data-urlencode 'sign_type=MD5'

返回参数

值为空的字段不返回，例如未付款的订单没有 endtime。

参数	类型	说明
`code`	Int	返回码，`1` 为成功
`trade_no`	String	站长单号
`out_trade_no`	String	商户单号，下单时传的商户单号
`api_trade_no`	String	三方单号
`type`	String	支付方式的调用值，见「支付方式」
`pid`	Int	商户号的数字部分
`addtime`	String	创建时间，下单时间
`endtime`	String	完成时间，付款成功的时间
`name`	String	商品名称
`money`	String	订单金额，单位元
`realmoney`	String	实付金额，单位元
`param`	String	扩展参数，下单时传的 `param`
`buyer`	String	付款人账号，付款人在支付平台的账号或标识
`status`	Int	订单状态，见下方「订单状态」
`refundmoney`	String	退款金额

trade_no：本站生成的订单号，19 位或 23～30 位（日期后接商户号），最长 32 位，按字符串处理，不要按定长存
api_trade_no：支付平台（微信、支付宝等）的订单号
refundmoney：累计已退款的金额，单位元；没退过款时不返回

返回示例

{
  "code": 1,
  "trade_no": "2026092712000012345",
  "out_trade_no": "20260927123456",
  "api_trade_no": "2026092722001412345678901234",
  "type": "alipay",
  "pid": 1001,
  "addtime": "2026-09-27 12:00:00",
  "endtime": "2026-09-27 12:00:35",
  "name": "会员充值",
  "money": "1.00",
  "realmoney": "1.00",
  "status": 1
}

订单状态

status	含义
`0`	未支付
`1`	已支付；返回了 `refundmoney` 的是部分退款
`2`	已退款或已关闭
`3`	已冻结

2：已退款或已关闭：返回了 refundmoney 的是已全额退款，没有的是已关闭

失败示例

{"code":-1,"msg":"订单不存在"}

两个单号都没传时返回「订单号不能为空」，商户与签名的错误见「错误码」。

注意事项

只能查到自己商户的订单。
不传 type 下单时，付款人在收银台选定支付方式之前订单还没生成，这时查询返回「订单不存在」。