# 打款批量查询

> 分页查询多笔打款记录。

```yaml
openapi: 3.1.0
info:
  title: 打款批量查询
  version: 1.0.0
  description: 分页查询多笔打款记录。
paths:
  /api/v1/txn/queryList:
    post:
      summary: 打款批量查询
      description: 分页查询多笔打款记录。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号。通常在沙盒或生产商户开通后，从商户后台或开户材料中获取。
                requestId:
                  type: string
                  description: 可选的商户请求流水号筛选条件。
                payoutId:
                  type: string
                  description: 可选的 Onerway 打款流水 ID 筛选条件。
                payoutStatus:
                  type: string
                  description: 可选的打款状态筛选条件。
                payoutStartTime:
                  type: string
                  description: 可选的打款时间开始值。
                payoutEndTime:
                  type: string
                  description: 可选的打款时间结束值。
                createTimeStartTime:
                  type: string
                  description: 创建时间窗口开始值。
                createTimeEndTime:
                  type: string
                  description: 创建时间窗口结束值。
                payoutMethod:
                  type: string
                  description: 可选的付款方式筛选条件。
                size:
                  type: integer
                  description: 每页条数。
                current:
                  type: integer
                  description: 当前页码。
                sign:
                  type: string
                  description: 请求签名字符串，需使用商户私钥按 Transfer 请求签名规则生成。
              required:
                - merchantNo
                - createTimeStartTime
                - createTimeEndTime
                - size
                - current
                - sign
            examples:
              query-transfers:
                summary: 批量查询打款
                value:
                  createTimeEndTime: 2025-09-10 12:00:00
                  createTimeStartTime: 2025-09-01 12:00:00
                  current: 1
                  merchantNo: "801129"
                  sign: "{{SIGN}}"
                  size: 10
              query-processing-transfers:
                summary: 按时间窗口查询处理中打款
                value:
                  createTimeEndTime: 2025-09-02 00:00:00
                  createTimeStartTime: 2025-09-01 00:00:00
                  current: 1
                  merchantNo: "801129"
                  payoutStatus: P
                  sign: "{{SIGN}}"
                  size: 20
      responses:
        "200":
          description: 分页打款结果
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: Onerway 返回的响应码。
                  respMsg:
                    type:
                      - string
                      - "null"
                    description: Onerway 返回的响应信息。
                    x-onerway-value:
                      nullable: true
                      when:
                        en: No response message is returned.
                        zh: 未返回响应信息时为 `null`。
                  data:
                    type: object
                    properties:
                      records:
                        type: array
                        description: 打款记录列表。
                        items:
                          type: object
                          properties:
                            payoutId:
                              type: string
                              description: Onerway 打款流水 ID。
                            requestId:
                              type: string
                              description: 商户请求流水号。
                            payoutStatus:
                              type: string
                              description: 打款状态。
                            payoutMethod:
                              type: string
                              description: 付款方式。
                      total:
                        type: integer
                        description: 总记录数。
                      size:
                        type: integer
                        description: 每页条数。
                      current:
                        type: integer
                        description: 当前页码。
                    description: 分页打款查询结果。
              examples:
                transfer-page:
                  summary: 分页打款结果
                  value:
                    respCode: "20000"
                    respMsg: null
                    data:
                      records:
                        - payoutId: "1965301538608513024"
                          requestId: DM202509090001
                          payoutStatus: S
                          payoutMethod: E_WALLET
                      total: 1
                      size: 10
                      current: 1
                transfer-page-mixed-status:
                  summary: 包含多种状态的分页打款结果
                  value:
                    respCode: "20000"
                    respMsg: null
                    data:
                      records:
                        - payoutId: "1965301538608513024"
                          requestId: DM202509090001
                          payoutStatus: S
                          payoutMethod: E_WALLET
                        - payoutId: "1965301538608513025"
                          requestId: DM202509090002
                          payoutStatus: P
                          payoutMethod: BANK_TRANSFER
                        - payoutId: "1965301538608513026"
                          requestId: DM202509090003
                          payoutStatus: F
                          payoutMethod: BANK_TRANSFER
                      total: 3
                      size: 20
                      current: 1
```