# 查询卡片操作记录

> 分页查询卡片操作记录，并支持可选筛选条件。

```yaml
openapi: 3.1.0
info:
  title: 查询卡片操作记录
  version: 1.0.0
  description: 分页查询卡片操作记录，并支持可选筛选条件。
paths:
  /api/v1/merchant/card/getOperateRecordList:
    post:
      summary: 查询卡片操作记录
      description: 分页查询卡片操作记录，并支持可选筛选条件。
      parameters:
        - name: ApiKey
          in: header
          required: true
          description: Onerway 分配的发卡 API key 请求 Header。
          schema:
            type: string
            description: Onerway 分配的发卡 API key 请求 Header。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                cardId:
                  type: integer
                  description: 卡片 ID 筛选条件；不传时可查询商户下所有卡片记录。
                clientRequestId:
                  type: string
                  description: 幂等请求 ID 筛选条件。
                type:
                  type: string
                  description: 操作类型筛选条件。
                  enum:
                    - CREATE
                    - FREEZE
                    - UNFREEZE
                    - DEPOSIT
                    - TERMINATE
                    - RETURN
                  x-enum-descriptions:
                    CREATE: 开卡操作。
                    FREEZE: 冻结操作。
                    UNFREEZE: 解冻操作。
                    DEPOSIT: 充值操作。
                    TERMINATE: 注销操作。
                    RETURN: 余额退回操作。
                startTime:
                  type: integer
                  description: 查询开始时间，UTC 秒级时间戳。
                endTime:
                  type: integer
                  description: 查询结束时间，UTC 秒级时间戳。
                pageNum:
                  type: integer
                  description: 页码。
                  x-onerway-constraints:
                    - kind: range
                      min: 1
                pageSize:
                  type: integer
                  description: 每页条数。
                  x-onerway-constraints:
                    - kind: range
                      min: 1
                      max: 100
              required:
                - pageNum
                - pageSize
            examples:
              default:
                summary: 查询操作记录
                value:
                  cardId: 100001
                  pageNum: 1
                  pageSize: 10
                  type: DEPOSIT
      responses:
        "200":
          description: 成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 业务响应码；`20000` 表示成功。
                  respMsg:
                    type: string
                    description: 响应信息。
                  data:
                    type:
                      - object
                      - "null"
                    properties:
                      totalRecords:
                        type: integer
                        description: 总记录数。
                      pageSize:
                        type: integer
                        description: 每页条数。
                      current:
                        type: integer
                        description: 当前页码。
                      pageNum:
                        type: integer
                        description: 当前页码。
                      totalPages:
                        type: integer
                        description: 总页数。
                      records:
                        type: array
                        description: 当前页操作记录。
                        items:
                          type: object
                          properties:
                            operateRecordId:
                              type: integer
                              description: 操作记录 ID。
                            cardId:
                              type: integer
                              description: 卡片 ID。
                            clientRequestId:
                              type: string
                              description: 幂等请求 ID。
                            type:
                              type: string
                              description: 操作类型。
                              enum:
                                - CREATE
                                - FREEZE
                                - UNFREEZE
                                - DEPOSIT
                                - TERMINATE
                                - RETURN
                                - SYSTEM_FREEZE
                                - SYSTEM_UNFREEZE
                              x-enum-descriptions:
                                CREATE: 开卡操作。
                                FREEZE: 冻结操作。
                                UNFREEZE: 解冻操作。
                                DEPOSIT: 充值操作。
                                TERMINATE: 注销操作。
                                RETURN: 余额退回操作。
                                SYSTEM_FREEZE: 系统冻结。
                                SYSTEM_UNFREEZE: 系统解冻。
                            status:
                              type: string
                              description: 操作状态。
                              enum:
                                - P
                                - S
                                - F
                                - I
                              x-enum-descriptions:
                                P: 处理中。
                                S: 成功。
                                F: 失败。
                                I: 待信息补充。
                            remark:
                              type:
                                - string
                                - "null"
                              description: 操作备注。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No remark is available.
                                  zh: 无备注时返回 `null`。
                            amount:
                              type: number
                              description: 操作金额。
                            currency:
                              type: string
                              description: 操作币种。
                            operateTime:
                              type: integer
                              description: 操作时间，UTC 毫秒级时间戳。
                            feeList:
                              type: array
                              description: 费用明细列表。
                              items:
                                type: object
                                properties:
                                  feeType:
                                    type: string
                                    description: 费用类型。
                                  feeAmount:
                                    type: number
                                    description: 费用金额。
                                  feeCurrency:
                                    type: string
                                    description: 费用币种。
                              x-onerway-value:
                                empty: true
                                when:
                                  en: Returned as an empty array when no fee applies.
                                  zh: 无费用时返回空数组。
                        x-onerway-value:
                          empty: true
                          when:
                            en: Returned as an empty array when no record matches.
                            zh: 没有匹配记录时返回空数组。
                    description: 分页操作记录。
                    x-onerway-value:
                      nullable: true
                      when:
                        en: Returned as `null` when the query fails.
                        zh: 查询失败时返回 `null`。
              examples:
                success:
                  summary: 成功
                  value:
                    respCode: "20000"
                    respMsg: success
                    data:
                      totalRecords: 1
                      pageSize: 10
                      current: 1
                      pageNum: 1
                      totalPages: 1
                      records:
                        - operateRecordId: 200001
                          cardId: 100001
                          clientRequestId: REQ_20260101_001
                          type: DEPOSIT
                          status: S
                          remark: null
                          amount: 100
                          currency: USD
                          operateTime: 1735689600000
                          feeList:
                            - feeType: DEPOSIT
                              feeAmount: 1
                              feeCurrency: USD
```