**版本：202701**

# 批量查询订单交易列表

**GET** `/openapi/2027-01/orders/transactions`

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

## 请求

**Query参数**

- `order_ids` string[]

  待查询的订单 ID 列表，单次最多 50 个。 示例：?order\_ids=1001&order\_ids=1002
- `cursor` string

  分页游标
- `page_size` int32

  每页交易笔数，范围 1-50，默认 10。
- `payment_channel` string

  支付渠道（如 paypal）。
- `status` string

  交易状态，对本次请求的全部订单生效：

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

## 响应

**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）校验结果代码
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录
  - `total` int32

    本次请求全部订单的交易总笔数

```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"
        }
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}
```