# Query transactions

> Query transaction records by merchant transaction IDs, Onerway transaction IDs, or creation time range.

```yaml
openapi: 3.1.0
info:
  title: Query transactions
  version: 1.0.0
  description: Query transaction records by merchant transaction IDs, Onerway
    transaction IDs, or creation time range.
paths:
  /v1/txn/list:
    post:
      summary: Query transactions
      description: Query transaction records by merchant transaction IDs, Onerway
        transaction IDs, or creation time range.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Merchant number assigned by Onerway. See
                    [Setup](/payments/get-started/setup#retrieve-your-credentials)
                    for how to obtain it.
                merchantTxnIds:
                  type: string
                  description: Comma-separated merchant transaction numbers used to query
                    transactions in batch.
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - Provide this field as one query condition. At least one of
                      `merchantTxnIds`, `transactionIds`, or `startTime` +
                      `endTime` is required.
                  x-onerway-constraints:
                    - kind: range
                      max: 10
                      unit: IDs
                      text: A single request can include up to 10 comma-separated IDs.
                transactionIds:
                  type: string
                  description: Comma-separated Onerway transaction IDs used to query transactions
                    in batch.
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - Provide this field as one query condition. At least one of
                      `merchantTxnIds`, `transactionIds`, or `startTime` +
                      `endTime` is required.
                  x-onerway-constraints:
                    - kind: range
                      max: 10
                      unit: IDs
                      text: A single request can include up to 10 comma-separated IDs.
                startTime:
                  type: string
                  description: Start of the query time range, filtered by transaction creation
                    time, in `yyyy-MM-dd HH:mm:ss` format.
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - Required together with `endTime` when querying by time
                      range. At least one of `merchantTxnIds`, `transactionIds`,
                      or `startTime` + `endTime` is required.
                  x-onerway-constraints:
                    - kind: rule
                      text: The maximum range between `startTime` and `endTime` is 90 days.
                endTime:
                  type: string
                  description: End of the query time range, in `yyyy-MM-dd HH:mm:ss` format.
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - Required together with `startTime` when querying by time
                      range.
                  x-onerway-constraints:
                    - kind: consistency
                      text: "`endTime` must be later than `startTime`."
                    - kind: rule
                      text: The maximum range between `startTime` and `endTime` is 90 days.
                txnTypes:
                  type: string
                  description: Transaction types used to filter results. Submit multiple values as
                    a comma-separated string. When omitted, Onerway returns all
                    transaction types.
                  enum:
                    - SALE
                    - AUTH
                    - REFUND
                  x-enum-descriptions:
                    SALE: Payment transaction.
                    AUTH: Authorization transaction.
                    REFUND: Refund transaction.
                current:
                  type: string
                  description: Query page number. `0` and `1` both mean the first page. The
                    response `current` value is always returned as a 1-based
                    page number.
                size:
                  type: string
                  description: Page size. The current endpoint returns 10 records per page and
                    does not support a custom page size.
                sign:
                  type: string
                  description: Request signature string. See [Request
                    signing](/payments/get-started/request-signing) for how to
                    generate it.
              required:
                - merchantNo
                - current
                - sign
            examples:
              american-express-cardholder-name-check-failed:
                summary: American Express cardholder name mismatch
                value:
                  merchantNo: replace_with_merchant_no
                  transactionIds: replace_with_transaction_id
                  current: "0"
                  sign: "{{SIGN}}"
              query-transactions-by-merchant-transaction-id:
                summary: Query transactions by merchant transaction ID
                value:
                  current: "1"
                  merchantNo: replace_with_merchant_no
                  merchantTxnIds: txn_demo_202606210001,txn_demo_202606210002
                  sign: "{{SIGN}}"
                  size: "10"
      responses:
        "200":
          description: American Express cardholder name mismatch
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: "`20000` means the query request was processed successfully. It
                      does not mean each transaction has succeeded. Other values
                      are error codes. See [Response
                      codes](/payments/api-reference/response-codes)."
                  respMsg:
                    type: string
                    description: Human-readable message for the response code.
                  data:
                    type: object
                    properties:
                      content:
                        type: array
                        description: Transaction records matching the query conditions. Each item is one
                          transaction detail record.
                        items:
                          type: object
                          properties:
                            transactionId:
                              type: string
                              description: Onerway transaction number for this transaction, transmitted as a
                                JSON string.
                            paymentId:
                              type: string
                              description: Payment intent ID, transmitted as a JSON string. One `paymentId`
                                can be associated with multiple `transactionId`
                                values.
                            merchantTxnId:
                              type: string
                              description: Merchant transaction number generated by the merchant for this
                                transaction.
                            merchantTxnOriginalId:
                              type:
                                - string
                                - "null"
                              description: Merchant-side original order number or original merchant
                                transaction reference.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the transaction references a merchant-side original order
                                    or a secondary transaction references an
                                    original transaction.
                                  zh: 交易关联商户侧原始订单或二级交易引用原始交易时有值。
                            originTransactionId:
                              type:
                                - string
                                - "null"
                              description: Original Onerway transaction ID referenced by a secondary
                                transaction, transmitted as a JSON string.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when a secondary transaction references an original transaction.
                                  zh: 二级交易引用原始交易时有值。
                            txnTime:
                              type:
                                - string
                                - "null"
                              description: Transaction time in `yyyy-MM-dd HH:mm:ss` format. It is not
                                necessarily the completion time.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when transaction time is returned.
                                  zh: 交易记录返回交易时间时有值。
                            txnTimeZone:
                              type:
                                - string
                                - "null"
                              description: Transaction time zone offset in `±HH:mm` format.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Returned together with `txnTime` when transaction time is returned.
                                  zh: 随 `txnTime` 返回。
                            txnCompletionTime:
                              type:
                                - string
                                - "null"
                              description: Transaction completion time in `yyyy-MM-dd HH:mm:ss` format.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value after the transaction completes.
                                  zh: 交易完成后才有值。
                            productType:
                              type: string
                              description: Payment product range used by this transaction.
                              enum:
                                - ALL
                                - CARD
                                - LPMS
                                - PAYMENT_CODE
                                - ORDER_CODE
                              x-enum-descriptions:
                                ALL: Aggregated checkout.
                                CARD: Card payment.
                                LPMS: Local payment method.
                                PAYMENT_CODE: Payment code.
                                ORDER_CODE: Order code.
                            subProductType:
                              type: string
                              description: Transaction processing mode under the payment product range.
                              enum:
                                - DIRECT
                                - SUBSCRIBE
                                - INSTALLMENT
                                - TOKEN
                                - AUTO_DEBIT
                              x-enum-descriptions:
                                DIRECT: Direct payment.
                                SUBSCRIBE: Subscription payment.
                                INSTALLMENT: Installment payment.
                                TOKEN: Token payment.
                                AUTO_DEBIT: Auto debit.
                            txnType:
                              type: string
                              description: Transaction operation type. Together with `productType` and
                                `subProductType`, it defines the transaction
                                model.
                              enum:
                                - SALE
                                - AUTH
                                - REFUND
                              x-enum-descriptions:
                                SALE: Payment transaction.
                                AUTH: Authorization transaction.
                                REFUND: Refund transaction.
                            status:
                              type: string
                              description: Current processing status of this transaction.
                              enum:
                                - S
                                - F
                                - P
                                - R
                                - N
                                - I
                                - U
                              x-enum-descriptions:
                                S: Successful transaction. This is a terminal status.
                                F: Failed transaction. This is a terminal status.
                                P: Transaction is processing. Do not treat it as final before a terminal status
                                  is returned.
                                R: Redirect is required to continue payment.
                                N: Canceled transaction. The transaction was closed because it was not paid
                                  within its validity window — for example, the
                                  checkout session timed out before the customer
                                  paid. This is a terminal status with no fund
                                  movement.
                                I: Transaction is under review or approval.
                                U: Waiting for payment.
                              x-onerway-constraints:
                                - kind: rule
                                  text: "`respCode=20000` only means the query request was processed successfully.
                                    Use this field to determine the result of
                                    each transaction record."
                            contractId:
                              type:
                                - string
                                - "null"
                              description: Subscription contract number. Store it when returned for later
                                subscription operations.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the transaction is associated with a subscription contract.
                                  zh: 交易记录关联订阅合约时才有值。
                            tokenId:
                              type:
                                - string
                                - "null"
                              description: Subscription token or saved payment method token. The two token
                                systems must not be mixed.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the transaction is associated with a subscription token or
                                    saved payment method token.
                                  zh: 交易记录关联订阅 token 或绑卡 token 时才有值。
                            userPaymentStatus:
                              type:
                                - string
                                - "null"
                              description: User payment status.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Relevant only for Sofort transactions. Ignore an empty value.
                                  zh: 仅 Sofort 交易关注此字段，空值时忽略。
                            cardType:
                              type:
                                - string
                                - "null"
                              description: Payment method type returned for the transaction.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when a specific payment method type is returned.
                                  zh: 交易返回具体支付方式类型时有值。
                            paymentMethod:
                              type:
                                - string
                                - "null"
                              description: Specific payment method used by the customer, covering card and
                                local payment methods.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value after the customer selects a payment method.
                                  zh: 客户已选定支付方式后才有值。
                            orderAmount:
                              type: string
                              description: Original order amount.
                            orderCurrency:
                              type: string
                              description: Original order currency as a three-letter [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217)
                                currency code.
                            settleRate:
                              type: string
                              description: Exchange rate between the order currency and settlement currency.
                                Used to calculate `txnAmount` from `orderAmount`
                                as `txnAmount = orderAmount * settleRate`.
                            txnAmount:
                              type: string
                              description: Settlement-currency amount converted from `orderAmount` by
                                `settleRate`.
                            txnCurrency:
                              type: string
                              description: Settlement currency as a three-letter [ISO
                                4217](https://en.wikipedia.org/wiki/ISO_4217)
                                currency code.
                            customsDeclarationAmount:
                              type:
                                - string
                                - "null"
                              description: Amount available for customs declaration.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value only for cross-border transactions that involve customs
                                    declaration.
                                  zh: 涉及海关申报的跨境交易才有值。
                            customsDeclarationCurrency:
                              type:
                                - string
                                - "null"
                              description: Currency for the customs declaration amount.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value only for cross-border transactions that involve customs
                                    declaration.
                                  zh: 涉及海关申报的跨境交易才有值。
                            arn:
                              type:
                                - string
                                - "null"
                              description: Acquirer Reference Number, used for reconciliation and dispute
                                handling.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value after an Acquirer Reference Number is generated for the
                                    transaction.
                                  zh: 交易生成 ARN 后才有值。
                            appId:
                              type:
                                - string
                                - "null"
                              description: Merchant application ID that processed this transaction.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the transaction is associated with a merchant application.
                                  zh: 交易关联到商户应用时有值。
                            website:
                              type:
                                - string
                                - "null"
                              description: Website domain that initiated the transaction.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the transaction records the initiating website.
                                  zh: 交易记录了发起域名时有值。
                            cardBinCountry:
                              type:
                                - string
                                - "null"
                              description: Country or region of the card BIN.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value for card transactions when the card BIN country or region can be
                                    identified.
                                  zh: 卡交易且可识别卡 BIN 所属国家 / 地区时有值。
                            cardNumber:
                              type:
                                - string
                                - "null"
                              description: Masked card number, keeping only the first 6 and last 4 digits.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value for card transactions.
                                  zh: 卡交易才有值。
                            walletTypeName:
                              type:
                                - string
                                - "null"
                              description: Wallet type name.
                              enum:
                                - GooglePay
                                - ApplePay
                                - EXPR
                                - JIOU
                                - XJK
                                - null
                              x-enum-descriptions:
                                GooglePay: Google Pay wallet.
                                ApplePay: Apple Pay wallet.
                                EXPR: "Wallet funding source: bank card."
                                JIOU: "Wallet funding source: Baitiao."
                                XJK: "Wallet funding source: Xiaojinku."
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when a digital wallet is used.
                                  zh: 使用数字钱包支付时才有值。
                            reason:
                              type:
                                - string
                                - "null"
                              description: Detailed transaction failure reason.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the transaction did not succeed.
                                  zh: 交易未成功时才有值。
                            holderName:
                              type:
                                - string
                                - "null"
                              description: Cardholder name.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value for card transactions.
                                  zh: 卡交易才有值。
                            eci:
                              type:
                                - string
                                - "null"
                              description: Electronic Commerce Indicator (ECI).
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when a card transaction or 3DS result returns an ECI.
                                  zh: 卡交易或 3DS 结果返回 ECI 时有值。
                            email:
                              type:
                                - string
                                - "null"
                              description: Customer email address.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the customer provided an email address.
                                  zh: 客户提供邮箱时有值。
                            creditCard:
                              type: object
                              properties:
                                holderName:
                                  type:
                                    - string
                                    - "null"
                                  description: Cardholder name.
                                  x-onerway-value:
                                    nullable: true
                                    when: &a10
                                      en: Has a value when cardholder name is returned.
                                      zh: 返回持卡人姓名时有值。
                                year:
                                  type:
                                    - string
                                    - "null"
                                  description: Card expiration year.
                                  x-onerway-value:
                                    nullable: true
                                    when: &a11
                                      en: Has a value when card expiration is returned.
                                      zh: 返回卡有效期时有值。
                                month:
                                  type:
                                    - string
                                    - "null"
                                  description: Card expiration month.
                                  x-onerway-value:
                                    nullable: true
                                    when: &a12
                                      en: Has a value when card expiration is returned.
                                      zh: 返回卡有效期时有值。
                                verificationResult:
                                  type:
                                    - object
                                    - "null"
                                  properties:
                                    version:
                                      type: string
                                      description: 3D Secure protocol version or `UNKNOWN`.
                                    authenticationFlow:
                                      type:
                                        - string
                                        - "null"
                                      description: 3DS authentication flow type.
                                      enum:
                                        - FRICTIONLESS
                                        - CHALLENGE
                                        - null
                                      x-enum-descriptions:
                                        FRICTIONLESS: Frictionless authentication; no additional customer interaction is
                                          required.
                                        CHALLENGE: Challenge authentication; the customer must complete an additional
                                          verification step.
                                      x-onerway-value:
                                        nullable: true
                                        when: &a1
                                          en: Has a value when the 3DS authentication flow can be identified.
                                          zh: 可识别 3DS 认证流程时有值。
                                    authenticationCode:
                                      type:
                                        - string
                                        - "null"
                                      description: Authentication or authorization code returned by 3DS or the payment
                                        channel.
                                      x-onerway-value:
                                        nullable: true
                                        when: &a2
                                          en: Has a value when the payment channel returns an authentication or
                                            authorization code.
                                          zh: 支付渠道返回认证 / 授权码时有值。
                                    chargebackLiability:
                                      type: string
                                      description: 3DS chargeback-liability party.
                                      enum:
                                        - ISSUER
                                        - MERCHANT
                                        - UNKNOWN
                                      x-enum-descriptions:
                                        ISSUER: Liability shifts to the issuer.
                                        MERCHANT: Liability remains with the merchant.
                                        UNKNOWN: Liability cannot be determined.
                                    transStatus:
                                      type:
                                        - string
                                        - "null"
                                      description: 3DS ACS authentication result.
                                      enum:
                                        - Y
                                        - N
                                        - A
                                        - U
                                        - R
                                        - null
                                      x-enum-descriptions:
                                        Y: Authentication succeeded.
                                        N: Authentication failed.
                                        A: Authentication was attempted.
                                        U: Authentication could not be completed.
                                        R: Authentication was rejected.
                                      x-onerway-value:
                                        nullable: true
                                        when: &a3
                                          en: Has a value when the ACS returns an authentication status.
                                          zh: ACS 返回认证状态时有值。
                                    transStatusReason:
                                      type:
                                        - string
                                        - "null"
                                      description: Detailed reason for the 3DS authentication status.
                                      x-onerway-value:
                                        nullable: true
                                        when: &a4
                                          en: Has a value when the 3DS authentication status needs an additional reason.
                                          zh: 需要补充说明 3DS 认证状态时有值。
                                    veresEnrolled:
                                      type:
                                        - string
                                        - "null"
                                      description: 3DS enrollment result.
                                      x-onerway-value:
                                        nullable: true
                                        when: &a5
                                          en: Has a value when the 3DS enrollment result is returned.
                                          zh: 3DS enrollment 结果返回时有值。
                                    eci:
                                      type:
                                        - string
                                        - "null"
                                      description: Electronic Commerce Indicator (ECI).
                                      x-onerway-value:
                                        nullable: true
                                        when: &a6
                                          en: Has a value when 3DS or the card transaction returns an ECI.
                                          zh: 3DS 或卡交易返回 ECI 时有值。
                                    cvvResult:
                                      type:
                                        - string
                                        - "null"
                                      description: CVV security-code check result.
                                      enum:
                                        - M
                                        - N
                                        - P
                                        - S
                                        - U
                                        - I
                                        - null
                                      x-enum-descriptions:
                                        M: CVV matched the issuer record.
                                        N: CVV did not match the issuer record.
                                        P: CVV processing error.
                                        S: CVV was missing from the card data.
                                        U: Verification service unavailable or unknown.
                                        I: CVV format is invalid.
                                      x-onerway-value:
                                        nullable: true
                                        when: &a7
                                          en: Has a value when the CVV check result is returned.
                                          zh: CVV 校验结果返回时有值。
                                    avsFullResult:
                                      type:
                                        - string
                                        - "null"
                                      description: Aggregated AVS address verification result.
                                      enum:
                                        - Y
                                        - N
                                        - A
                                        - Z
                                        - U
                                        - null
                                      x-enum-descriptions:
                                        Y: Postal code and street address both match.
                                        N: Postal code and street address both do not match.
                                        A: Street address matches and postal code does not match.
                                        Z: Postal code matches and street address does not match.
                                        U: Address verification system is unavailable.
                                      x-onerway-value:
                                        nullable: true
                                        when: &a8
                                          en: Has a value when the aggregated AVS result is returned.
                                          zh: AVS 综合校验结果返回时有值。
                                    cavvResult:
                                      type:
                                        - string
                                        - "null"
                                      description: Cardholder Authentication Verification Value returned by 3DS
                                        authentication.
                                      x-onerway-value:
                                        nullable: true
                                        when: &a9
                                          en: Has a value when 3DS authentication returns a CAVV.
                                          zh: 3DS 认证返回 CAVV 时有值。
                                  description: Card verification result object.
                                  x-onerway-value:
                                    nullable: true
                                    when:
                                      en: Has a value when card verification results are returned.
                                      zh: 返回卡验证结果时有值。
                                cardType:
                                  type: string
                                  description: Payment method type.
                                productCategory:
                                  type:
                                    - string
                                    - "null"
                                  description: Card product category.
                                  enum:
                                    - D
                                    - P
                                    - C
                                    - H
                                    - R
                                    - N
                                    - null
                                  x-enum-descriptions:
                                    D: Debit
                                    P: Prepaid
                                    C: Credit
                                    H: Charge Card
                                    R: Deferred Debit
                                    N: Unknown
                                  x-onerway-value:
                                    nullable: true
                                    when: &a13
                                      en: Has a value when the card network returns card product category.
                                      zh: 卡组织返回卡产品类别时有值。
                                issuer:
                                  type:
                                    - string
                                    - "null"
                                  description: Card issuer name.
                                  x-onerway-value:
                                    nullable: true
                                    when: &a14
                                      en: Has a value when the issuer can be identified.
                                      zh: 可识别发卡行时有值。
                                cardBinCountry:
                                  type:
                                    - string
                                    - "null"
                                  description: Country or region of the card BIN.
                                  x-onerway-value:
                                    nullable: true
                                    when: &a15
                                      en: Has a value when the card BIN country or region can be identified.
                                      zh: 可识别卡 BIN 所属国家 / 地区时有值。
                                authorizationCode:
                                  type:
                                    - string
                                    - "null"
                                  description: Authorization code returned by the acquirer or issuer.
                                  x-onerway-value:
                                    nullable: true
                                    when: &a16
                                      en: Has a value when the payment channel returns an authorization code.
                                      zh: 支付渠道返回授权码时有值。
                                cardNumber:
                                  type:
                                    - string
                                    - "null"
                                  description: Masked card number, keeping only the first 6 and last 4 digits.
                                  x-onerway-value:
                                    nullable: true
                                    when: &a17
                                      en: Has a value when masked card number is returned.
                                      zh: 返回卡号信息时有值。
                              description: Compatibility card information object. Fields overlap with
                                flattened card fields and parts of
                                `paymentMethodDetails.card`.
                            channelRequestId:
                              type:
                                - string
                                - "null"
                              description: Payment channel or processor request identifier.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value after the transaction enters payment channel processing.
                                  zh: 交易进入支付渠道处理后才有值。
                            lpmsUserId:
                              type:
                                - string
                                - "null"
                              description: Local payment method user identifier.
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when a local payment method transaction is associated with a
                                    channel user identifier.
                                  zh: 本地支付方式交易关联到渠道用户标识时有值。
                            paymentMethodDetails:
                              type: object
                              properties:
                                card:
                                  type: object
                                  properties:
                                    checks:
                                      type:
                                        - object
                                        - "null"
                                      properties:
                                        addressCheck:
                                          type:
                                            - string
                                            - "null"
                                          description: AVS street-address check result.
                                          enum:
                                            - pass
                                            - fail
                                            - unavailable
                                            - unchecked
                                            - notProvided
                                            - unsupported
                                            - null
                                          x-enum-descriptions:
                                            pass: The information submitted for verification matches issuer records.
                                            fail: The information submitted for verification does not match issuer records.
                                            unavailable: The issuer does not support this verification.
                                            unchecked: Verification was not performed.
                                            notProvided: The information required for this verification was not provided.
                                            unsupported: AVS is not supported for this transaction.
                                          x-onerway-value:
                                            nullable: true
                                            when:
                                              en: Has a value when AVS street-address verification is performed.
                                              zh: 执行 AVS 街道地址校验时有值。
                                        postalCodeCheck:
                                          type:
                                            - string
                                            - "null"
                                          description: AVS postal-code check result.
                                          enum:
                                            - pass
                                            - fail
                                            - unavailable
                                            - unchecked
                                            - notProvided
                                            - unsupported
                                            - null
                                          x-enum-descriptions:
                                            pass: The information submitted for verification matches issuer records.
                                            fail: The information submitted for verification does not match issuer records.
                                            unavailable: The issuer does not support this verification.
                                            unchecked: Verification was not performed.
                                            notProvided: The information required for this verification was not provided.
                                            unsupported: AVS is not supported for this transaction.
                                          x-onerway-value:
                                            nullable: true
                                            when:
                                              en: Has a value when AVS postal-code verification is performed.
                                              zh: 执行 AVS 邮编校验时有值。
                                        cardholderNameCheck:
                                          type:
                                            - string
                                            - "null"
                                          description: American Express AVS result indicating whether the cardholder name
                                            matches issuer records.
                                          enum:
                                            - pass
                                            - fail
                                            - unavailable
                                            - unchecked
                                            - notProvided
                                            - unsupported
                                            - null
                                          x-enum-descriptions:
                                            pass: The information submitted for verification matches issuer records.
                                            fail: The information submitted for verification does not match issuer records.
                                            unavailable: The issuer does not support this verification.
                                            unchecked: Verification was not performed.
                                            notProvided: The information required for this verification was not provided.
                                            unsupported: AVS is not supported for this transaction.
                                          x-onerway-value:
                                            nullable: true
                                            when:
                                              en: Returns the result when American Express cardholder name verification is
                                                performed, or `null` if it is
                                                not performed.
                                              zh: 执行 American Express 持卡人姓名验证时返回验证结果；未执行时返回 `null`。
                                        avsResultRawCode:
                                          type:
                                            - string
                                            - "null"
                                          description: Raw AVS result code returned by the card network or Onerway.
                                          enum:
                                            - Y
                                            - N
                                            - A
                                            - Z
                                            - U
                                            - null
                                          x-enum-descriptions:
                                            Y: Postal code and street address both match.
                                            N: Postal code and street address both do not match.
                                            A: Street address matches and postal code does not match.
                                            Z: Postal code matches and street address does not match.
                                            U: Address verification is unavailable.
                                          x-onerway-value:
                                            nullable: true
                                            when:
                                              en: Has a value when a card network or Onerway returns a raw AVS result code.
                                              zh: 卡组织或 Onerway 返回原始 AVS 结果码时有值。
                                        threeDSecureResult:
                                          type:
                                            - object
                                            - "null"
                                          properties:
                                            version:
                                              type: string
                                              description: 3D Secure protocol version or `UNKNOWN`.
                                            authenticationFlow:
                                              type:
                                                - string
                                                - "null"
                                              description: 3DS authentication flow type.
                                              enum:
                                                - FRICTIONLESS
                                                - CHALLENGE
                                                - null
                                              x-enum-descriptions:
                                                FRICTIONLESS: Frictionless authentication; no additional customer interaction is
                                                  required.
                                                CHALLENGE: Challenge authentication; the customer must complete an additional
                                                  verification step.
                                              x-onerway-value:
                                                nullable: true
                                                when: *a1
                                            authenticationCode:
                                              type:
                                                - string
                                                - "null"
                                              description: Authentication or authorization code returned by 3DS or the payment
                                                channel.
                                              x-onerway-value:
                                                nullable: true
                                                when: *a2
                                            chargebackLiability:
                                              type: string
                                              description: 3DS chargeback-liability party.
                                              enum:
                                                - ISSUER
                                                - MERCHANT
                                                - UNKNOWN
                                              x-enum-descriptions:
                                                ISSUER: Liability shifts to the issuer.
                                                MERCHANT: Liability remains with the merchant.
                                                UNKNOWN: Liability cannot be determined.
                                            transStatus:
                                              type:
                                                - string
                                                - "null"
                                              description: 3DS ACS authentication result.
                                              enum:
                                                - Y
                                                - N
                                                - A
                                                - U
                                                - R
                                                - null
                                              x-enum-descriptions:
                                                Y: Authentication succeeded.
                                                N: Authentication failed.
                                                A: Authentication was attempted.
                                                U: Authentication could not be completed.
                                                R: Authentication was rejected.
                                              x-onerway-value:
                                                nullable: true
                                                when: *a3
                                            transStatusReason:
                                              type:
                                                - string
                                                - "null"
                                              description: Detailed reason for the 3DS authentication status.
                                              x-onerway-value:
                                                nullable: true
                                                when: *a4
                                            veresEnrolled:
                                              type:
                                                - string
                                                - "null"
                                              description: 3DS enrollment result.
                                              x-onerway-value:
                                                nullable: true
                                                when: *a5
                                            eci:
                                              type:
                                                - string
                                                - "null"
                                              description: Electronic Commerce Indicator (ECI).
                                              x-onerway-value:
                                                nullable: true
                                                when: *a6
                                            cvvResult:
                                              type:
                                                - string
                                                - "null"
                                              description: CVV security-code check result.
                                              enum:
                                                - M
                                                - N
                                                - P
                                                - S
                                                - U
                                                - I
                                                - null
                                              x-enum-descriptions:
                                                M: CVV matched the issuer record.
                                                N: CVV did not match the issuer record.
                                                P: CVV processing error.
                                                S: CVV was missing from the card data.
                                                U: Verification service unavailable or unknown.
                                                I: CVV format is invalid.
                                              x-onerway-value:
                                                nullable: true
                                                when: *a7
                                            avsFullResult:
                                              type:
                                                - string
                                                - "null"
                                              description: Aggregated AVS address verification result.
                                              enum:
                                                - Y
                                                - N
                                                - A
                                                - Z
                                                - U
                                                - null
                                              x-enum-descriptions:
                                                Y: Postal code and street address both match.
                                                N: Postal code and street address both do not match.
                                                A: Street address matches and postal code does not match.
                                                Z: Postal code matches and street address does not match.
                                                U: Address verification system is unavailable.
                                              x-onerway-value:
                                                nullable: true
                                                when: *a8
                                            cavvResult:
                                              type:
                                                - string
                                                - "null"
                                              description: Cardholder Authentication Verification Value returned by 3DS
                                                authentication.
                                              x-onerway-value:
                                                nullable: true
                                                when: *a9
                                          description: 3D Secure verification result.
                                          x-onerway-value:
                                            nullable: true
                                            when:
                                              en: Has a value when 3DS verification results are returned.
                                              zh: 返回 3DS 验证结果时有值。
                                      description: Verification checks, including AVS and 3DS results.
                                      x-onerway-value:
                                        nullable: true
                                        when:
                                          en: Has a value when AVS, 3DS, or CVV verification results are returned.
                                          zh: 支付渠道返回 AVS / 3DS / CVV 验证结果时有值。
                                    holderName:
                                      type:
                                        - string
                                        - "null"
                                      description: Cardholder name.
                                      x-onerway-value:
                                        nullable: true
                                        when: *a10
                                    year:
                                      type:
                                        - string
                                        - "null"
                                      description: Card expiration year.
                                      x-onerway-value:
                                        nullable: true
                                        when: *a11
                                    month:
                                      type:
                                        - string
                                        - "null"
                                      description: Card expiration month.
                                      x-onerway-value:
                                        nullable: true
                                        when: *a12
                                    cardType:
                                      type: string
                                      description: Payment method type.
                                    productCategory:
                                      type:
                                        - string
                                        - "null"
                                      description: Card product category.
                                      enum:
                                        - D
                                        - P
                                        - C
                                        - H
                                        - R
                                        - N
                                        - null
                                      x-enum-descriptions:
                                        D: Debit
                                        P: Prepaid
                                        C: Credit
                                        H: Charge Card
                                        R: Deferred Debit
                                        N: Unknown
                                      x-onerway-value:
                                        nullable: true
                                        when: *a13
                                    issuer:
                                      type:
                                        - string
                                        - "null"
                                      description: Card issuer name.
                                      x-onerway-value:
                                        nullable: true
                                        when: *a14
                                    cardBinCountry:
                                      type:
                                        - string
                                        - "null"
                                      description: Country or region of the card BIN.
                                      x-onerway-value:
                                        nullable: true
                                        when: *a15
                                    authorizationCode:
                                      type:
                                        - string
                                        - "null"
                                      description: Authorization code returned by the acquirer or issuer.
                                      x-onerway-value:
                                        nullable: true
                                        when: *a16
                                    cardNumber:
                                      type:
                                        - string
                                        - "null"
                                      description: Masked card number, keeping only the first 6 and last 4 digits.
                                      x-onerway-value:
                                        nullable: true
                                        when: *a17
                                  description: Card or compatible payment method details.
                              description: Payment method details. The `card` child object carries card
                                details or compatible payment method details and
                                verification checks.
                            metaData:
                              type:
                                - string
                                - "null"
                              description: Merchant-defined custom metadata that can be used for
                                reconciliation and business context.
                              x-onerway-value:
                                nullable: true
                                empty: true
                                when:
                                  en: Has a value only when custom metadata was submitted in the payment request
                                    or subscription configuration.
                                  zh: 商户在支付请求或订阅配置中传入了自定义数据才有值，未传入时为空。
                      current:
                        type: string
                        description: Returned page number, using 1-based numbering.
                      size:
                        type: number
                        description: Number of records in the current page. The current page size is
                          fixed at 10 records.
                      totalPages:
                        type: number
                        description: Total number of pages based on the current page size.
                      totalElements:
                        type: number
                        description: Total number of transactions matching the query conditions.
                    description: Business data object containing transaction records and pagination
                      information.
              examples:
                american-express-cardholder-name-check-failed:
                  summary: American Express cardholder name mismatch
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      content:
                        - transactionId: replace_with_transaction_id
                          paymentId: replace_with_payment_id
                          merchantTxnId: example_merchant_transaction_id
                          merchantTxnOriginalId: null
                          txnTime: 2026-01-15 10:30:00
                          txnTimeZone: +08:00
                          txnCompletionTime: 2026-01-15 10:30:30
                          originTransactionId: null
                          productType: CARD
                          subProductType: DIRECT
                          txnType: SALE
                          status: S
                          contractId: null
                          tokenId: null
                          userPaymentStatus: null
                          cardType: AE
                          paymentMethod: AE
                          orderAmount: "100.00"
                          settleRate: "1"
                          orderCurrency: USD
                          txnAmount: "100.00"
                          txnCurrency: USD
                          customsDeclarationAmount: null
                          customsDeclarationCurrency: null
                          arn: null
                          appId: replace_with_app_id
                          website: https://merchant.example.com
                          cardBinCountry: US
                          cardNumber: 370000******0002
                          walletTypeName: null
                          reason: null
                          holderName: Example Cardholder
                          eci: null
                          email: customer@example.com
                          creditCard:
                            holderName: Example Cardholder
                            year: "2029"
                            month: "11"
                            verificationResult: null
                            cardType: AE
                            productCategory: null
                            issuer: Example American Express Issuer
                            cardNumber: 370000******0002
                          channelRequestId: replace_with_channel_request_id
                          lpmsUserId: null
                          paymentMethodDetails:
                            card:
                              checks:
                                addressCheck: fail
                                postalCodeCheck: fail
                                cardholderNameCheck: fail
                                avsResultRawCode: W
                                threeDSecureResult: null
                              holderName: Example Cardholder
                              year: "2029"
                              month: "11"
                              cardType: AE
                              productCategory: null
                              issuer: Example American Express Issuer
                              cardBinCountry: US
                              authorizationCode: replace_with_authorization_code
                              cardNumber: 370000******0002
                          metaData: null
                      current: "1"
                      size: 10
                      totalPages: 1
                      totalElements: 1
```
