获取订单列表

API文档最后更新: 2026-10-28

获取订单列表

通用鉴权、响应、返回字段和错误说明见接入指南。

GET /openapi/v1/seller/orders?page=1&pageSize=20&status=pending

查询参数

类型

说明

page / pageSize

integer

默认 1/20,最大每页 100

status

string

按订单状态精确筛选;不传时不限定

productType

string

card、recharge、physical;不传时不限定

orderNo

string

订单号精确筛选

查询全部时省略对应参数;all 不属于这两个筛选字段的约定值。

{
  "code": 0,
  "message": "success",
  "data": {
    "list": [{
      "id": 12345,
      "orderNo": "D26102812345678901",
      "goodsName": "充值商品",
      "skuName": "",
      "productType": "recharge",
      "quantity": 1,
      "status": "pending",
      "fulfillmentStatus": "pending",
      "isPay": true,
      "isSeller": true,
      "role": "seller",
      "totalPrice": 10,
      "createdAt": 1793145600,
      "paymentTime": 1793145601,
      "completedAt": 0
    }],
    "total": 1,
    "page": 1,
    "pageSize": 20
  },
  "requestId": "req_example"
}

对于 role=supplier 的纯供货订单,不返回买家的 totalPrice、refundedAmount,返回本店的 supplyAmount。缺少历史供货报价时 supplyAmount=null,不能当成零元或用当前商品价格反推。