**版本：202601**

# 查询支付订单列表

**GET** `/openapi/2026-01/shoplazza-payment/payment-orders`

分页返回支付订单列表，可按状态和创建时间范围过滤。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数（1-100，默认 10）
- `created_at_min` string

  筛选在该 Unix 时间及之后创建的支付订单（如 1730548810）
- `created_at_max` string

  筛选在该 Unix 时间及之前创建的支付订单（如 1730548810）
- `status` string

  按状态筛选支付订单：

  *   `succeeded`: 支付成功，资金已确认到账
  *   `failed`: 支付失败，资金未被处理
  *   `requires_action`: 需要额外操作才能完成支付（如 3D Secure 验证）
  *   `init`: 支付订单已创建但尚未处理
  *   `canceled`: 支付订单已取消，资金未被处理或已退回
  *   `processing`: 支付处理中，最终结果待确认

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `list` object[]

    支付订单记录列表

    *   Array \[

    - `id` string

      支付订单 ID
    - `fee_details` object

      此支付订单的交易费用明细

      - `trans_fee_amount` string

        支付订单收取的交易费金额
      - `fee_currency` string

        交易费的币种代码（如 USD、EUR）
      - `foreign_settlement_fee` string

        跨地区或跨币种结算时收取的境外结算费
    - `created_at` string

      支付订单的创建时间（如 2018-11-02T12:30:10Z）
    - `finished_at` string

      支付订单完成的时间（如 2018-11-02T12:30:10Z）
    - `payment_status` string

      订单当前的支付状态：

      *   `succeeded`: 支付成功，资金已确认到账
      *   `failed`: 支付失败，资金未被处理
      *   `requires_action`: 需要额外操作才能完成支付（如 3D Secure 验证）
      *   `init`: 支付订单已创建但尚未处理
      *   `canceled`: 支付订单已取消，资金未被处理或已退回
      *   `processing`: 支付处理中，最终结果待确认
    - `payment_method` string

      支付订单所使用的支付方式（如信用卡、PayPal）
    - `card_brand` string

      支付所使用信用卡的品牌（如 Visa、Mastercard）
    - `pay_currency` string

      消费者实际支付所使用的币种代码（如 USD、EUR）
    - `pay_amount` string

      消费者以 pay\_currency 实际支付的金额
    - `converted_amount` string

      支付金额折算为店铺基础币种后的数值
    - `reserve_amount` string

      预留金额
    - `order_id` string

      与此次支付关联的订单标识符
    - `fee_amount` string

      此支付订单的服务费总额
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "id": "string",
        "fee_details": {
          "trans_fee_amount": "string",
          "fee_currency": "string",
          "foreign_settlement_fee": "string"
        },
        "created_at": "string",
        "finished_at": "string",
        "payment_status": "string",
        "payment_method": "string",
        "card_brand": "string",
        "pay_currency": "string",
        "pay_amount": "string",
        "converted_amount": "string",
        "reserve_amount": "string",
        "order_id": "string",
        "fee_amount": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```