批量查询
分页查询自己商户的订单,最新的订单排在最前面。
请求地址
https://z.weixiao.cc/orders,POST 表单。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
pid | String | 必填 | 商户号,「API信息」里的商户号 |
status | Int | 否 | 订单状态 |
limit | Int | 否 | 每次条数,默认 10,最大 50 |
offset | Int | 否 | 跳过条数 |
sign | String | 必填 | 签名 |
sign_type | String | 否 | 签名类型 |
status:只查这个状态的订单,取值见「查询订单」的订单状态;不传查全部offset:从第几条之后开始返回,默认 0;翻到第 N 页时传 (N − 1) × limitsign:见「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'返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
code | Int | 返回码,1 为成功 |
msg | String | 返回信息 |
count | Int | 订单总数,符合条件的订单总数,用来算页数 |
data | Array | 订单列表 |
data:本次返回的订单,没有订单时为空数组
订单字段
data 里每笔订单都有下面这些字段,没有值的为 null。
| 参数 | 类型 | 说明 |
|---|---|---|
trade_no | String | 站长单号 |
out_trade_no | String | 商户单号 |
api_trade_no | String | 三方单号,支付平台的订单号 |
type | Int | 支付方式编号 |
name | String | 商品名称 |
money | String | 订单金额,单位元 |
realmoney | String | 实付金额,单位元 |
param | String | 扩展参数,下单时传的 param |
buyer | String | 付款人账号,付款人在支付平台的账号或标识 |
status | Int | 订单状态,见「查询订单」的订单状态 |
addtime | String | 创建时间 |
endtime | String | 完成时间,付款成功的时间 |
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是调用值,注意区分。