订单

批量查询

分页查询自己商户的订单,最新的订单排在最前面。

请求地址

https://z.weixiao.cc/orders,POST 表单。

请求参数

参数类型必填说明
pidString必填商户号,「API信息」里的商户号
statusInt否订单状态
limitInt否每次条数,默认 10,最大 50
offsetInt否跳过条数
signString必填签名
sign_typeString否签名类型
  • status:只查这个状态的订单,取值见「查询订单」的订单状态;不传查全部
  • offset:从第几条之后开始返回,默认 0;翻到第 N 页时传 (N − 1) × limit
  • sign:见「V1(MD5签名)」「V2(RSA签名)」
  • sign_type:MD5 或 RSA,不传按 MD5;签名方式为「RSA签名」的商户必须传 RSA

请求示例

curl -X POST 'https://z.weixiao.cc/orders' \
  --data-urlencode 'pid=1001' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'offset=0' \
  --data-urlencode 'sign=你算出的签名' \
  --data-urlencode 'sign_type=MD5'

返回参数

参数类型说明
codeInt返回码,1 为成功
msgString返回信息
countInt订单总数,符合条件的订单总数,用来算页数
dataArray订单列表
  • data:本次返回的订单,没有订单时为空数组

订单字段

data 里每笔订单都有下面这些字段,没有值的为 null。

参数类型说明
trade_noString站长单号
out_trade_noString商户单号
api_trade_noString三方单号,支付平台的订单号
typeInt支付方式编号
nameString商品名称
moneyString订单金额,单位元
realmoneyString实付金额,单位元
paramString扩展参数,下单时传的 param
buyerString付款人账号,付款人在支付平台的账号或标识
statusInt订单状态,见「查询订单」的订单状态
addtimeString创建时间
endtimeString完成时间,付款成功的时间
  • trade_no:本站生成的订单号,19 位或 23~30 位(日期后接商户号),最长 32 位,按字符串处理,不要按定长存
  • type:这里是编号而不是调用值,对照见「支付方式」

返回示例

{
  "code": 1,
  "msg": "查询订单记录成功",
  "count": 1,
  "data": [
    {
      "trade_no": "2026092712000012345",
      "out_trade_no": "20260927123456",
      "api_trade_no": "2026092722001412345678901234",
      "type": 1,
      "name": "会员充值",
      "money": "1.00",
      "realmoney": "1.00",
      "param": "uid=88",
      "buyer": null,
      "status": 1,
      "addtime": "2026-09-27 12:00:00",
      "endtime": "2026-09-27 12:00:35"
    }
  ]
}

注意事项

  • 按创建时间倒序返回,最新的订单在第一条。
  • limit 小于 1 时按 10 处理,大于 50 时按 50 处理。
  • 批量查询里的 type 是编号,查询订单和支付结果通知里的 type 是调用值,注意区分。