# 打款方查询

> 分页查询已保存的打款方。

```yaml
openapi: 3.1.0
info:
  title: 打款方查询
  version: 1.0.0
  description: 分页查询已保存的打款方。
paths:
  /api/v1/acct/queryPayer:
    post:
      summary: 打款方查询
      description: 分页查询已保存的打款方。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                size:
                  type: integer
                  description: 每页条数；支持时可用 `-1` 请求全部记录。
                current:
                  type: integer
                  description: 当前页码。
                column:
                  type: string
                  description: 排序字段名。
                asc:
                  type: boolean
                  description: 是否按升序排序。
                id:
                  type: string
                  description: 可选的付款方 ID 筛选条件。
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号。通常在沙盒或生产商户开通后，从商户后台或开户材料中获取。
                subEntityType:
                  type: string
                  description: 可选的打款主体类型筛选条件。
                companyName:
                  type: string
                  description: 可选的公司名称筛选条件。
                companyNameEn:
                  type: string
                  description: 可选的英文公司名称筛选条件。
                firstName:
                  type: string
                  description: 可选的名字筛选条件。
                lastName:
                  type: string
                  description: 可选的姓氏筛选条件。
                country:
                  type: string
                  description: 可选的国家筛选条件。
                registerNo:
                  type: string
                  description: 可选的注册号筛选条件。
                idType:
                  type: string
                  description: 可选的证件类型筛选条件。
                registerDate:
                  type: string
                  description: 可选的注册日期筛选条件。
                sign:
                  type: string
                  description: 请求签名字符串，需使用商户私钥按 Transfer 请求签名规则生成。
              required:
                - size
                - current
                - column
                - asc
                - merchantNo
                - sign
            examples:
              query-payers:
                summary: 查询付款方
                value:
                  asc: false
                  column: create_time
                  current: 1
                  merchantNo: "801129"
                  sign: "{{SIGN}}"
                  size: 10
      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:
                            id:
                              type: string
                              description: 付款方 ID。
                            merchantNo:
                              type: string
                              description: 商户号。
                            subEntityType:
                              type: string
                              description: 打款主体类型。
                            country:
                              type: string
                              description: 付款方国家。
                      total:
                        type: integer
                        description: 总记录数。
                      size:
                        type: integer
                        description: 每页条数。
                      current:
                        type: integer
                        description: 当前页码。
                    description: 分页付款方查询结果。
              examples:
                payer-list:
                  summary: 返回付款方列表
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      records:
                        - id: "1984096429476806656"
                          merchantNo: "801129"
                          subEntityType: "0"
                          country: GB
                      total: 1
                      size: 10
                      current: 1
```