**版本：202601**

# 查询订单交易列表

**GET** `/openapi/2026-01/orders/:order_id/transactions`

查询指定订单下的全部交易记录，包含交易状态、支付渠道、金额及网关返回信息等。

## 请求

**Path参数**

- `order_id` string (required)

  订单 ID

**Query参数**

- `status` string

  交易状态：

  *   `authorized`: 已授权但尚未扣款
  *   `void`: 已取消
  *   `processing`: 处理中
  *   `success`: 交易成功
  *   `failure` / `error`: 交易失败，数据中两个值都存在，按失败过滤时需分别查询
  *   `refunding`: 退款中
  *   `refunded`: 已退款
  *   `refund_failed`: 退款失败
  *   `expired`: 已过期
- `payment_channel` string

  支付渠道（如 paypal）

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `transactions` object[]

    交易列表

    *   Array \[

    - `id` string

      交易 ID
    - `order_id` string

      该交易所属订单 ID
    - `payment_channel` string

      处理该交易的支付渠道（如 paypal）
    - `message` string

      支付网关返回的消息，通常用于描述处理结果或错误原因
    - `created_at` string

      交易创建时间（如 2018-11-02T12:30:10Z）
    - `test` boolean

      是否为测试交易
    - `error_code` string

      交易失败时支付网关返回的错误代码
    - `amount` string

      交易金额
    - `currency` string

      交易金额的货币代码（如 USD）
    - `trade_id` string

      第三方支付平台返回的交易流水号
    - `status` string

      交易状态：

      *   `authorized`: 已授权但尚未扣款
      *   `void`: 已取消
      *   `processing`: 处理中
      *   `success`: 交易成功
      *   `failure` / `error`: 交易失败，数据中两个值都存在，判断失败时需同时兼容
      *   `refunding`: 退款中
      *   `refunded`: 已退款
      *   `refund_failed`: 退款失败
      *   `expired`: 已过期
    - `payment_name` string

      该交易所使用支付方式的展示名称
    - `payment_detail` object

      支付方式详情，例如银行卡信息

      - `card_number` string

        卡号
      - `card_month` string

        卡有效期月份
      - `card_year` string

        卡有效期年份
      - `card_first_name` string

        持卡人名
      - `card_last_name` string

        持卡人姓
      - `card_first_fix` string

        卡号前缀（BIN，用于标识发卡机构的起始数字）
      - `card_last_four` string

        卡号后四位
      - `avs_result_code` string

        支付网关返回的地址验证系统（AVS）结果代码
      - `cvv_result_code` string

        支付网关返回的卡安全码（CVV）校验结果代码
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "transactions": [
      {
        "id": "string",
        "order_id": "string",
        "payment_channel": "string",
        "message": "string",
        "created_at": "string",
        "test": true,
        "error_code": "string",
        "amount": "string",
        "currency": "string",
        "trade_id": "string",
        "status": "string",
        "payment_name": "string",
        "payment_detail": {
          "card_number": "string",
          "card_month": "string",
          "card_year": "string",
          "card_first_name": "string",
          "card_last_name": "string",
          "card_first_fix": "string",
          "card_last_four": "string",
          "avs_result_code": "string",
          "cvv_result_code": "string"
        }
      }
    ]
  }
}
```