# 查询交易记录

> 分页查询卡交易记录，并支持可选筛选条件。

```yaml
openapi: 3.1.0
info:
  title: 查询交易记录
  version: 1.0.0
  description: 分页查询卡交易记录，并支持可选筛选条件。
paths:
  /api/v1/merchant/queryTxnList:
    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:
                txnType:
                  type: string
                  description: 交易类型筛选条件。
                  enum:
                    - AUTHORIZATION
                    - REVERSAL
                    - CLEARING
                    - REFUND
                    - VERIFICATION
                  x-enum-descriptions:
                    AUTHORIZATION: 授权交易。
                    REVERSAL: 撤销交易。
                    CLEARING: 清算交易。
                    REFUND: 退款交易。
                    VERIFICATION: 验证交易。
                txnStatus:
                  type: string
                  description: 交易状态筛选条件。
                  enum:
                    - S
                    - F
                    - P
                  x-enum-descriptions:
                    S: 成功。
                    F: 失败。
                    P: 处理中。
                cardId:
                  type: string
                  description: 卡片 ID 筛选条件。
                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
                  txnType: AUTHORIZATION
      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:
                            txnType:
                              type: string
                              description: 交易类型。
                              enum:
                                - AUTHORIZATION
                                - REVERSAL
                                - CLEARING
                                - REFUND
                                - VERIFICATION
                              x-enum-descriptions:
                                AUTHORIZATION: 授权交易。
                                REVERSAL: 撤销交易。
                                CLEARING: 清算交易。
                                REFUND: 退款交易。
                                VERIFICATION: 验证交易。
                            txnStatus:
                              type: string
                              description: 交易状态。
                              enum:
                                - S
                                - F
                                - P
                              x-enum-descriptions:
                                S: 成功。
                                F: 失败。
                                P: 处理中。
                            txnOrderNo:
                              type: string
                              description: 交易订单号。
                            originTxnOrderNo:
                              type:
                                - string
                                - "null"
                              description: 原交易订单号。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No original transaction applies.
                                  zh: 无原交易时返回 `null`。
                            originTxnOrderNoForRefund:
                              type:
                                - string
                                - "null"
                              description: 退款原支付订单号。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No original payment order applies for refund.
                                  zh: 无退款原支付订单时返回 `null`。
                            cardId:
                              type: string
                              description: 交易记录返回的卡片 ID 或脱敏卡标识。
                            authTime:
                              type:
                                - integer
                                - "null"
                              description: 授权时间，UTC 毫秒级时间戳。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No authorization time applies.
                                  zh: 无授权时间时返回 `null`。
                            authorizationCode:
                              type:
                                - string
                                - "null"
                              description: 授权码。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No authorization code applies.
                                  zh: 无授权码时返回 `null`。
                            authMessageDesc:
                              type:
                                - string
                                - "null"
                              description: 授权说明。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No authorization description applies.
                                  zh: 无授权说明时返回 `null`。
                            transactionAmount:
                              type: number
                              description: 交易金额。
                            transactionCurrency:
                              type: string
                              description: 交易币种。
                            transactionTime:
                              type: integer
                              description: 交易时间，UTC 毫秒级时间戳。
                            cardAmount:
                              type: number
                              description: 卡片金额。
                            cardCurrency:
                              type: string
                              description: 卡片币种。
                            settleAmount:
                              type:
                                - number
                                - "null"
                              description: 清算金额。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No settlement amount applies.
                                  zh: 无清算金额时返回 `null`。
                            settleCurrency:
                              type:
                                - string
                                - "null"
                              description: 清算币种。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No settlement currency applies.
                                  zh: 无清算币种时返回 `null`。
                            settleTime:
                              type:
                                - integer
                                - "null"
                              description: 清算时间，UTC 毫秒级时间戳。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No settlement time applies.
                                  zh: 无清算时间时返回 `null`。
                            transactionFee:
                              type:
                                - number
                                - "null"
                              description: 交易手续费。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No transaction fee applies.
                                  zh: 无交易手续费时返回 `null`。
                            transactionFeeCurrency:
                              type:
                                - string
                                - "null"
                              description: 交易手续费币种。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No transaction fee applies.
                                  zh: 无交易手续费时返回 `null`。
                            crossBorderFee:
                              type:
                                - number
                                - "null"
                              description: 跨境手续费。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No cross-border fee applies.
                                  zh: 无跨境手续费时返回 `null`。
                            crossBorderFeeCurrency:
                              type:
                                - string
                                - "null"
                              description: 跨境手续费币种。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No cross-border fee applies.
                                  zh: 无跨境手续费时返回 `null`。
                            exchangeFee:
                              type:
                                - number
                                - "null"
                              description: 换汇手续费。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No exchange fee applies.
                                  zh: 无换汇手续费时返回 `null`。
                            exchangeFeeCurrency:
                              type:
                                - string
                                - "null"
                              description: 换汇手续费币种。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No exchange fee applies.
                                  zh: 无换汇手续费时返回 `null`。
                            merchantId:
                              type:
                                - string
                                - "null"
                              description: 卡交易中的商户 ID。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No merchant descriptor is available.
                                  zh: 无商户描述信息时返回 `null`。
                            merchantName:
                              type:
                                - string
                                - "null"
                              description: 商户名称。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No merchant descriptor is available.
                                  zh: 无商户描述信息时返回 `null`。
                            merchantCountry:
                              type:
                                - string
                                - "null"
                              description: 商户国家。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No merchant country is available.
                                  zh: 无商户国家信息时返回 `null`。
                            merchantCountryCode:
                              type:
                                - string
                                - "null"
                              description: 商户国家代码。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No merchant country code is available.
                                  zh: 无商户国家代码时返回 `null`。
                            merchantStateProvince:
                              type:
                                - string
                                - "null"
                              description: 商户州 / 省。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No merchant state or province is available.
                                  zh: 无商户州 / 省信息时返回 `null`。
                            merchantCity:
                              type:
                                - string
                                - "null"
                              description: 商户城市。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No merchant city is available.
                                  zh: 无商户城市信息时返回 `null`。
                            merchantPostalCode:
                              type:
                                - string
                                - "null"
                              description: 商户邮编。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No merchant postal code is available.
                                  zh: 无商户邮编时返回 `null`。
                            merchantMccCode:
                              type:
                                - string
                                - "null"
                              description: 商户 MCC。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: No merchant MCC is available.
                                  zh: 无商户 MCC 时返回 `null`。
                        x-onerway-value:
                          empty: true
                          when:
                            en: Returned as an empty array when no transaction 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:
                        - txnType: AUTHORIZATION
                          txnStatus: S
                          txnOrderNo: TXN20260101001
                          originTxnOrderNo: null
                          originTxnOrderNoForRefund: null
                          cardId: "100001"
                          authTime: 1735689600000
                          authorizationCode: AUTH001
                          authMessageDesc: Approved
                          transactionAmount: 50
                          transactionCurrency: USD
                          transactionTime: 1735689600000
                          cardAmount: 50
                          cardCurrency: USD
                          settleAmount: 50
                          settleCurrency: USD
                          settleTime: 1735776000000
                          transactionFee: 0.5
                          transactionFeeCurrency: USD
                          crossBorderFee: null
                          crossBorderFeeCurrency: null
                          exchangeFee: null
                          exchangeFeeCurrency: null
                          merchantId: example_merchant_id
                          merchantName: Example Merchant
                          merchantCountry: United States
                          merchantCountryCode: US
                          merchantStateProvince: WA
                          merchantCity: Seattle
                          merchantPostalCode: "98101"
                          merchantMccCode: "5411"
```