读取订单行属于自己目录的订单，不能把订单标成已支付

GET/api/v1/manage/orders

认证	请求头 Authorization: Bearer <访问令牌>，访问令牌用设备码换取，不要向用户要密码、短信验证码或 API Key
权限	商家，需要 order:read 才能查看本店订单或处理未履约收款，不能把订单标成已支付

查询参数

application/json

查询参数可省略

catalog_idstring

只看这一本目录的订单

查询示例

catalog_id=catalog_id_example

响应

200

application/json

没有 next_cursor

itemsobject[]必填

本店订单

items[].idstring必填

订单 ID

items[].statusenum<string>必填

只有 paid 表示支付成功

可选值: pendingpaidclosed

items[].amountinteger必填

订单金额，整数分

items[].currencystring必填

货币代码

items[].updated_atstring必填

更新时间，ISO-8601

items[].items[].idstring必填

订单行 ID

items[].items[].variant_idstring必填

下单时的规格 ID

items[].items[].qtyinteger必填

数量

items[].items[].amountinteger必填

行金额，整数分

items[].payment.idstring

支付记录 ID，没有支付记录时 payment 为 null

items[].payment.providerstring

支付实现，由服务端固定

items[].payment.channelenum<string>

已保存的收银台

可选值: desktopmobile

items[].payment.statusstring

支付记录状态

items[].payment.actionstring | null

完整支付 URL，打开它不等于已支付

items[].unapplied_receipt.statusenum<string>

未履约收款状态，没有时为 null

可选值: openfulfilled_manuallyrefundedrefund_failed

items[].unapplied_receipt.amountinteger

收款金额，整数分

items[].unapplied_receipt.provider_trade_nostring

服务商交易号

items[].unapplied_receipt.failure_reasonstring | null

失败原因，没有时为 null

响应示例

{
  "items": [
    {
      "id": "id_example",
      "status": "pending",
      "amount": 159900,
      "currency": "CNY",
      "updated_at": "2026-05-16T00:00:00.000Z",
      "items": [
        {
          "id": "id_example",
          "variant_id": "var_example",
          "qty": 1,
          "amount": 159900
        }
      ],
      "payment": {
        "id": "pay_example",
        "provider": "string",
        "channel": "desktop",
        "status": "pay_example",
        "action": null
      },
      "unapplied_receipt": {
        "status": "open",
        "amount": 159900,
        "provider_trade_no": "string",
        "failure_reason": null
      }
    }
  ]
}