# 查询支付记录

> 按支付意图、交易标识或时间范围查询支付记录。

```yaml
openapi: 3.1.0
info:
  title: 查询支付记录
  version: 1.0.0
  description: 按支付意图、交易标识或时间范围查询支付记录。
paths:
  /v1/txn/queryPayments:
    post:
      summary: 查询支付记录
      description: 按支付意图、交易标识或时间范围查询支付记录。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号；获取方式参见[接入准备](/zh/payments/get-started/setup#获取凭证)。
                merchantTxnIds:
                  type: string
                  description: 按商户交易号批量查询 Payment 记录，多个值以逗号分隔。
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - 作为查询条件之一提供；`merchantTxnIds` / `transactionIds` /
                      `startTime` + `endTime` / `paymentId` 至少提供一类。
                  x-onerway-constraints:
                    - kind: range
                      max: 10
                      unit: 个 ID
                      text: 单次请求最多传入 10 个以逗号分隔的 ID。
                transactionIds:
                  type: string
                  description: 按 Onerway 交易号批量查询 Payment 记录，多个值以逗号分隔。
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - 作为查询条件之一提供；`merchantTxnIds` / `transactionIds` /
                      `startTime` + `endTime` / `paymentId` 至少提供一类。
                  x-onerway-constraints:
                    - kind: range
                      max: 10
                      unit: 个 ID
                      text: 单次请求最多传入 10 个以逗号分隔的 ID。
                paymentId:
                  type: string
                  description: 支付意图 ID，JSON 中以 `String` 传输。用于按 Payment 维度检索关联交易与退款记录。
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - 作为查询条件之一提供；`merchantTxnIds` / `transactionIds` /
                      `startTime` + `endTime` / `paymentId` 至少提供一类。
                txnTypes:
                  type: string
                  description: 按 Payment 下关联交易类型过滤，多个值以逗号分隔；本接口支持 `SALE` 和 `REFUND`。
                  enum:
                    - SALE
                    - REFUND
                  x-enum-descriptions:
                    SALE: 支付。
                    REFUND: 退款。
                  x-onerway-constraints:
                    - kind: values
                      text: 本接口仅支持通用 `TxnTypeEnum` 中的 `SALE` / `REFUND` 子集。
                startTime:
                  type: string
                  description: 查询时间范围起点，格式 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - 按时间范围查询时需与 `endTime` 成对提供；`merchantTxnIds` /
                      `transactionIds` / `startTime` + `endTime` / `paymentId`
                      至少提供一类。
                  x-onerway-constraints:
                    - kind: rule
                      text: "`startTime` 与 `endTime` 的区间最大 90 天。"
                endTime:
                  type: string
                  description: 查询时间范围终点，格式 `yyyy-MM-dd HH:mm:ss`。
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - 按时间范围查询时需与 `startTime` 成对提供。
                  x-onerway-constraints:
                    - kind: consistency
                      text: "`endTime` 必须晚于 `startTime`。"
                    - kind: rule
                      text: "`startTime` 与 `endTime` 的区间最大 90 天。"
                current:
                  type: string
                  description: 支付记录查询页码。`0` 和 `1` 都表示第一页；响应中的 `current` 统一返回 1-based 页码。
                size:
                  type: string
                  description: 分页大小；单次分页查询最多返回 `10` 条。
                sign:
                  type: string
                  description: 请求签名字符串；生成方式详见[请求签名](/zh/payments/get-started/request-signing)。
              required:
                - merchantNo
                - current
                - sign
            examples:
              american-express-cardholder-name-check-failed:
                summary: American Express 持卡人姓名不匹配
                value:
                  merchantNo: replace_with_merchant_no
                  paymentId: replace_with_payment_id
                  current: "0"
                  size: "10"
                  sign: "{{SIGN}}"
              query-payments-by-payment-id:
                summary: 按 paymentId 查询支付记录
                value:
                  current: "1"
                  merchantNo: replace_with_merchant_no
                  paymentId: "2031908578000000000"
                  sign: "{{SIGN}}"
                  size: "10"
      responses:
        "200":
          description: American Express 持卡人姓名不匹配
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 响应码；`20000`
                      表示查询请求处理成功（指请求受理成功，非单笔交易结果），其余为错误码。完整码表见[响应码](/zh/payments/api-reference/response-codes)。
                  respMsg:
                    type: string
                    description: 响应码对应的可读说明。
                  data:
                    type: object
                    properties:
                      content:
                        type: array
                        description: 符合查询条件的 Payment 记录列表，每条记录以支付意图维度汇总关联交易尝试。
                        items:
                          type: object
                          properties:
                            paymentId:
                              type: string
                              description: 支付意图 ID，JSON 中以 `String` 传输。一个 `paymentId` 可关联多笔 `transactionId`。
                            paymentStatus:
                              type: string
                              description: 支付意图级状态，反映同一 `paymentId` 下跨多次尝试的生命周期状态。
                              enum:
                                - I
                                - U
                                - P
                                - R
                                - A
                                - O
                                - S
                                - N
                              x-enum-descriptions:
                                I: 已初始化；支付意图已创建，等待首次支付尝试。
                                U: 待支付；等待客户发起或完成支付动作。
                                P: 处理中；某次支付尝试正在处理。
                                R: 已跳转；客户被跳转以完成额外步骤，如 3DS 或本地支付页。
                                A: 已授权；资金已授权，等待后续动作，如请款。
                                O: 开放；支付意图保持开放，可继续发起新的尝试。
                                S: 成功；支付意图达到最终成功。
                                N: 已关闭；支付意图因超时未支付或多次尝试失败而关闭。
                            lastTransactionId:
                              type:
                                - string
                                - "null"
                              description: 该支付意图下最后一笔交易尝试的 Onerway 交易号。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the payment intent already has a last transaction attempt.
                                    Records without a formed transaction attempt
                                    can return `null`.
                                  zh: 支付意图已有最后一笔交易尝试时有值；未形成交易尝试的记录可为 `null`。
                            lastPaymentAttempt:
                              type:
                                - object
                                - "null"
                              properties:
                                {}
                              description: 最后一次支付尝试的结果摘要。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Returns `null` when no last payment-attempt summary is available.
                                  zh: 没有最后一次支付尝试摘要时返回 `null`。
                              x-onerway-lifecycle:
                                status: new
                                since: 2026-06-15
                                description:
                                  en: New field for the result summary of the last payment attempt.
                                  zh: 最后一次支付尝试结果摘要的新字段。
                            merchantTxnId:
                              type: string
                              description: 商户为本次交易生成的商户交易号。
                            merchantTxnOriginalId:
                              type:
                                - string
                                - "null"
                              description: 商户主订单或原始交易对应的商户交易号。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the payment record is associated with a merchant master
                                    order or original transaction. Ordinary
                                    single-attempt samples can return `null`.
                                  zh: Payment 记录关联商户主订单或原始交易时才有值；普通单笔尝试样例可为 `null`。
                            txnTime:
                              type: string
                              description: 最后一次尝试的交易时间，格式 `yyyy-MM-dd HH:mm:ss`。
                            txnCompletionTime:
                              type:
                                - string
                                - "null"
                              description: 最后一次尝试的完成时间，格式 `yyyy-MM-dd HH:mm:ss`。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the last attempt is completed and a completion time is
                                    returned. It can be `null` when no attempt
                                    is formed, no completion state has been
                                    reached, or the channel is still processing.
                                  zh: 最后一次尝试已完成并返回完成时间时有值；未形成交易尝试、未进入完成态或渠道仍在处理时可为 `null`。
                            productType:
                              type: string
                              description: 本次 Payment 记录关联交易使用的支付产品范围。
                              enum:
                                - ALL
                                - CARD
                                - LPMS
                                - PAYMENT_CODE
                                - ORDER_CODE
                              x-enum-descriptions:
                                ALL: 聚合收银台；仅用于收银台支付场景，表示打开聚合收银台。
                                CARD: 信用卡。
                                LPMS: 本地支付方式。
                                PAYMENT_CODE: 支付码；商家扫用户的支付码。
                                ORDER_CODE: 订单码；用户扫商家的订单码。
                              x-onerway-constraints:
                                - kind: consistency
                                  text: 共享枚举仅表示值域字典；接口级可用范围仍需结合查询上下文和已记录的接口行为。
                            subProductType:
                              type: string
                              description: 支付产品范围下的交易处理模式。
                              enum:
                                - DIRECT
                                - SUBSCRIBE
                                - INSTALLMENT
                                - TOKEN
                                - AUTO_DEBIT
                              x-enum-descriptions:
                                DIRECT: 直接支付。
                                SUBSCRIBE: 订阅支付。
                                INSTALLMENT: 分期支付。
                                TOKEN: token 支付。
                                AUTO_DEBIT: 代扣。
                              x-onerway-constraints:
                                - kind: consistency
                                  text: 共享枚举仅表示值域字典；接口级可用范围仍需结合查询上下文和已记录的接口行为。
                            cardType:
                              type:
                                - string
                                - "null"
                              description: 支付方式类型或卡品牌；卡交易常见返回卡组织取值，本地支付可返回支付方式名。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the payment method or card type has been selected. It is
                                    `null` when no method has been selected or
                                    no transaction attempt has been formed.
                                  zh: 已选定支付方式 / 卡类型时有值；未选定或未形成交易尝试时为 `null`。
                            orderAmount:
                              type: string
                              description: 下单金额（原始交易金额），如有小数保留两位。
                            orderCurrency:
                              type: string
                              description: 下单币种，[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 三位字母货币代码。
                            txnAmount:
                              type:
                                - string
                                - "null"
                              description: 最后一次交易尝试的交易金额。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the last transaction attempt produced a transaction amount.
                                    It is `null` when no attempt is formed or no
                                    transaction amount is produced.
                                  zh: 最后一次交易尝试产生交易金额时有值；未形成交易尝试或未产生交易金额时为 `null`。
                            txnCurrency:
                              type:
                                - string
                                - "null"
                              description: 最后一次交易尝试的交易币种，[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
                                三位字母货币代码。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the last transaction attempt produced a transaction
                                    currency. It is `null` when no attempt is
                                    formed or no transaction currency is
                                    produced.
                                  zh: 最后一次交易尝试产生交易币种时有值；未形成交易尝试或未产生交易币种时为 `null`。
                            arn:
                              type:
                                - string
                                - "null"
                              description: 收单行参考号（ARN），可用于对账与争议处理。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value only after an ARN is generated and returned for the transaction.
                                  zh: 交易生成 ARN 后才有值；未生成或未返回时为 `null`。
                            appId:
                              type:
                                - string
                                - "null"
                              description: 处理本次交易的商户应用 ID（商户注册网站时由 Onerway 创建）。
                              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: 发起交易的网站域名。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the transaction source website is recorded.
                                  zh: 记录交易来源站点时有值。
                            cardNumber:
                              type:
                                - string
                                - "null"
                              description: 脱敏卡号，仅保留前 6 位和后 4 位，中间位掩码。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when this is a card transaction and masked card information is
                                    returned. Even `CARD` records can return
                                    `null`.
                                  zh: 卡交易且返回卡信息时有值；即使 `CARD` 记录也可能为 `null`。
                            holderName:
                              type:
                                - string
                                - "null"
                              description: 持卡人姓名。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when this is a card transaction and cardholder information is
                                    returned. Even `CARD` records can return
                                    `null`.
                                  zh: 卡交易且返回持卡人信息时有值；即使 `CARD` 记录也可能为 `null`。
                            eci:
                              type:
                                - string
                                - "null"
                              description: 电子商务指示符（ECI），标识交易安全等级与责任转移。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when card transaction or 3DS results return an ECI.
                                  zh: 卡交易或 3DS 结果返回 ECI 时有值。
                            email:
                              type:
                                - string
                                - "null"
                              description: 客户电子邮件地址。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when the customer provides an email address.
                                  zh: 客户提供邮箱时有值。
                            channelRequestId:
                              type:
                                - string
                                - "null"
                              description: 支付渠道侧的请求标识，可用于渠道侧对账。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value only after the transaction enters payment-channel processing and
                                    the channel generates a request identifier.
                                    It is `null` before a channel request is
                                    formed.
                                  zh: 交易进入支付渠道处理并生成渠道请求标识后才有值；未形成渠道请求时为 `null`。
                            paymentMethodDetails:
                              type:
                                - object
                                - "null"
                              properties:
                                card:
                                  type:
                                    - object
                                    - "null"
                                  properties:
                                    holderName:
                                      type: string
                                      description: 持卡人姓名。
                                    year:
                                      type: string
                                      description: 卡有效期年份，4 位。
                                    month:
                                      type: string
                                      description: 卡有效期月份，2 位，取值 `01`–`12`。
                                    cardType:
                                      type: string
                                      description: 卡品牌 / 卡组织。
                                    productCategory:
                                      type:
                                        - string
                                        - "null"
                                      description: 卡产品类别。
                                      enum:
                                        - D
                                        - P
                                        - C
                                        - H
                                        - R
                                        - N
                                        - null
                                      x-enum-descriptions:
                                        D: 借记卡
                                        P: 预付卡
                                        C: 信用卡
                                        H: 签账卡
                                        R: 延迟借记卡
                                        N: 未知
                                      x-onerway-value:
                                        nullable: true
                                        when:
                                          en: Has a value when the card network returns a card product category.
                                          zh: 卡组织返回卡产品类别时有值。
                                    issuer:
                                      type:
                                        - string
                                        - "null"
                                      description: 发卡行（发行该卡的金融机构）名称。
                                      x-onerway-value:
                                        nullable: true
                                        when:
                                          en: Has a value when the issuer can be identified.
                                          zh: 可识别发卡行时有值。
                                    cardBinCountry:
                                      type:
                                        - string
                                        - "null"
                                      description: 卡 BIN（银行识别号）所属国家 / 地区。
                                      x-onerway-value:
                                        nullable: true
                                        when:
                                          en: Has a value when the card BIN country or region can be identified.
                                          zh: 可识别卡 BIN 所属国家 / 地区时有值。
                                    authorizationCode:
                                      type:
                                        - string
                                        - "null"
                                      description: 收单行 / 发卡行返回的授权码。
                                      x-onerway-value:
                                        nullable: true
                                        when:
                                          en: Has a value after card transaction authorization succeeds.
                                          zh: 卡交易授权成功后才有值。
                                    cardNumber:
                                      type: string
                                      description: 脱敏卡号，仅保留前 6 位和后 4 位，中间位掩码。
                                    checks:
                                      type:
                                        - object
                                        - "null"
                                      properties:
                                        addressCheck:
                                          type:
                                            - string
                                            - "null"
                                          description: AVS 街道地址校验结果；账单街道地址是否与发卡行记录匹配。
                                          enum:
                                            - pass
                                            - fail
                                            - unavailable
                                            - unchecked
                                            - notProvided
                                            - unsupported
                                            - null
                                          x-enum-descriptions:
                                            pass: 提交验证的信息与发卡行记录一致。
                                            fail: 提交验证的信息与发卡行记录不一致。
                                            unavailable: 发卡行不支持此类验证。
                                            unchecked: 未执行验证。
                                            notProvided: 未提供本次验证所需的信息。
                                            unsupported: 此交易不支持 AVS。
                                          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 邮政编码校验结果；账单邮编是否与发卡行记录匹配。
                                          enum:
                                            - pass
                                            - fail
                                            - unavailable
                                            - unchecked
                                            - notProvided
                                            - unsupported
                                            - null
                                          x-enum-descriptions:
                                            pass: 提交验证的信息与发卡行记录一致。
                                            fail: 提交验证的信息与发卡行记录不一致。
                                            unavailable: 发卡行不支持此类验证。
                                            unchecked: 未执行验证。
                                            notProvided: 未提供本次验证所需的信息。
                                            unsupported: 此交易不支持 AVS。
                                          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 持卡人姓名验证结果，表示姓名是否与发卡行记录一致。
                                          enum:
                                            - pass
                                            - fail
                                            - unavailable
                                            - unchecked
                                            - notProvided
                                            - unsupported
                                            - null
                                          x-enum-descriptions:
                                            pass: 提交验证的信息与发卡行记录一致。
                                            fail: 提交验证的信息与发卡行记录不一致。
                                            unavailable: 发卡行不支持此类验证。
                                            unchecked: 未执行验证。
                                            notProvided: 未提供本次验证所需的信息。
                                            unsupported: 此交易不支持 AVS。
                                          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: 卡组织（Visa / Mastercard）返回的原始 AVS 结果码。
                                          enum:
                                            - N
                                            - S
                                            - U
                                            - R
                                            - W
                                            - Z
                                            - X
                                            - Y
                                            - M
                                            - F
                                            - D
                                            - A
                                            - B
                                            - P
                                            - G
                                            - I
                                            - C
                                            - FD
                                            - NP
                                            - null
                                          x-enum-descriptions:
                                            N: 邮政编码和街道地址都不匹配。
                                            S: 不支持 AVS。
                                            U: 验证服务不可用。
                                            R: 系统无法执行。
                                            W: 9 位邮编匹配，地址不匹配。
                                            Z: 5 位邮编匹配，地址不匹配。
                                            X: 9 位邮编和地址都匹配。
                                            Y: 5 位邮编和地址都匹配。
                                            M: 地址和邮编匹配（仅国际）。
                                            F: 地址和邮编匹配（仅英国）。
                                            D: 地址和邮编匹配（仅国际）。
                                            A: 地址匹配，邮编不匹配。
                                            B: 地址匹配，邮编未验证。
                                            P: 邮编匹配，地址未验证。
                                            G: 非 AVS 参与者（美国境外）。
                                            I: 国际交易地址未验证。
                                            C: 地址和邮编未验证（非美国 Visa 卡）。
                                            FD: AVS 验证不可用（Onerway 系统码）。
                                            NP: 未提供地址和邮编（Onerway 系统码）。
                                          x-onerway-value:
                                            nullable: true
                                            when:
                                              en: Has a value when the card network or Onerway returns a raw AVS result code.
                                              zh: 卡组织或 Onerway 返回原始 AVS 结果码时有值。
                                        threeDSecureResult:
                                          type:
                                            - object
                                            - "null"
                                          properties:
                                            version:
                                              type: string
                                              description: 3D Secure 协议版本或 `UNKNOWN`。
                                            authenticationFlow:
                                              type:
                                                - string
                                                - "null"
                                              description: 3DS 认证流程类型，用于区分无摩擦认证与挑战认证。
                                              x-onerway-value:
                                                nullable: true
                                                when:
                                                  en: Has a value when the 3DS authentication flow can be identified.
                                                  zh: 可识别 3DS 认证流程时有值。
                                            chargebackLiability:
                                              type: string
                                              description: 3DS 拒付责任承担方或 `UNKNOWN`。
                                            transStatus:
                                              type:
                                                - string
                                                - "null"
                                              description: 3DS（ACS）认证结果。
                                              enum:
                                                - Y
                                                - N
                                                - A
                                                - U
                                                - R
                                                - null
                                              x-enum-descriptions:
                                                Y: 认证成功。
                                                N: 认证失败。
                                                A: 已尝试认证。
                                                U: 无法完成认证。
                                                R: 认证被拒绝。
                                              x-onerway-value:
                                                nullable: true
                                                when:
                                                  en: Has a value when the ACS returns an authentication status.
                                                  zh: ACS 返回认证状态时有值。
                                            transStatusReason:
                                              type:
                                                - string
                                                - "null"
                                              description: 3DS 认证状态的详细原因说明。
                                              x-onerway-value:
                                                nullable: true
                                                when:
                                                  en: Has a value when the 3DS authentication status needs an additional reason.
                                                  zh: 需要补充说明 3DS 认证状态时有值。
                                            veresEnrolled:
                                              type:
                                                - string
                                                - "null"
                                              description: 3DS enrollment 结果。
                                              x-onerway-value:
                                                nullable: true
                                                when:
                                                  en: Has a value when the 3DS enrollment result is returned.
                                                  zh: 3DS enrollment 结果返回时有值。
                                            eci:
                                              type:
                                                - string
                                                - "null"
                                              description: 电子商务指示符（ECI）。
                                              x-onerway-value:
                                                nullable: true
                                                when:
                                                  en: Has a value when 3DS or the card transaction returns an ECI.
                                                  zh: 3DS 或卡交易返回 ECI 时有值。
                                            cvvResult:
                                              type:
                                                - string
                                                - "null"
                                              description: CVV 安全码校验结果；安全码是否与发卡行记录匹配。
                                              enum:
                                                - M
                                                - N
                                                - P
                                                - S
                                                - U
                                                - I
                                                - null
                                              x-enum-descriptions:
                                                M: CVV 匹配成功；安全码与发卡行记录匹配。
                                                N: CVV 不匹配；安全码与发卡行记录不符。
                                                P: CVV 处理错误；处理器无法验证（技术问题）。
                                                S: CVV 缺失；卡未提供 CVV。
                                                U: 系统不可用；验证服务不可用或未知。
                                                I: CVV 无效；安全码格式无效（长度或字符错误）。
                                              x-onerway-value:
                                                nullable: true
                                                when:
                                                  en: Has a value when the CVV check result is returned.
                                                  zh: CVV 校验结果返回时有值。
                                            avsFullResult:
                                              type:
                                                - string
                                                - "null"
                                              description: AVS 地址验证综合结果；账单地址是否与发卡行记录匹配。
                                              enum:
                                                - Y
                                                - N
                                                - A
                                                - Z
                                                - U
                                                - null
                                              x-enum-descriptions:
                                                Y: 邮政编码与街道地址都匹配。
                                                N: 邮政编码与街道地址都不匹配。
                                                A: 街道地址匹配，邮政编码不匹配。
                                                Z: 邮政编码匹配，街道地址不匹配。
                                                U: 系统不可用；地址验证系统离线，非拒绝原因。
                                              x-onerway-value:
                                                nullable: true
                                                when:
                                                  en: Has a value when the aggregated AVS result is returned.
                                                  zh: AVS 综合校验结果返回时有值。
                                            cavvResult:
                                              type:
                                                - string
                                                - "null"
                                              description: 3DS 认证返回的 CAVV 加密值，是责任转移的必要条件。
                                              x-onerway-value:
                                                nullable: true
                                                when:
                                                  en: Has a value when 3DS authentication returns a CAVV.
                                                  zh: 3DS 认证返回 CAVV 时有值。
                                          description: 3D Secure 验证结果。
                                          x-onerway-value:
                                            nullable: true
                                            when:
                                              en: Has a value when 3DS verification results are returned.
                                              zh: 返回 3DS 验证结果时有值。
                                      description: 验证检查结果，包含 AVS 与 3DS 结果。
                                      x-onerway-value:
                                        nullable: true
                                        when:
                                          en: Has a value when the payment channel returns AVS, 3DS, or CVV verification
                                            results. The 2026-06-15
                                            successful-card sample had `card`
                                            populated while `checks` was `null`.
                                          zh: 支付渠道返回 AVS / 3DS / CVV 验证结果时有值；2026-06-15 成功卡交易样例中 `card` 有值但 `checks` 为
                                            `null`。
                                  description: 卡支付方式详情。
                                  x-onerway-value:
                                    nullable: true
                                    when:
                                      en: Has a value when parent `paymentMethodDetails` is present and contains card
                                        payment method details.
                                      zh: 父级 `paymentMethodDetails` 有值且包含卡支付方式详情时有值。
                              description: 支付方式详情对象；卡信息位于 `card` 子对象，包含卡明细与验证检查结果。
                              x-onerway-value:
                                nullable: true
                                when:
                                  en: Has a value when payment method details are returned. Even `CARD` records
                                    can return `null`. When non-null, card
                                    information is carried in the `card` child
                                    object.
                                  zh: 返回支付方式详情时有值；即使 `CARD` 记录也可能为 `null`。非 `null` 时卡信息位于 `card` 子对象。
                      current:
                        type: string
                        description: 当前返回的页码（1-based）。
                      size:
                        type: number
                        description: 当前页分页大小；单次分页查询最多返回 `10` 条。
                      totalPages:
                        type: number
                        description: 按当前页大小计算的总页数。
                      totalElements:
                        type: number
                        description: 符合查询条件的 Payment 记录总条数。
                    description: 业务数据对象，包含 Payment 记录列表与分页信息。
              examples:
                american-express-cardholder-name-check-failed:
                  summary: American Express 持卡人姓名不匹配
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      content:
                        - paymentId: replace_with_payment_id
                          paymentStatus: S
                          lastTransactionId: replace_with_transaction_id
                          lastPaymentAttempt: null
                          merchantTxnId: example_merchant_transaction_id
                          merchantTxnOriginalId: null
                          txnTime: 2026-01-15 10:30:00
                          txnCompletionTime: 2026-01-15 10:30:30
                          productType: CARD
                          subProductType: DIRECT
                          cardType: AE
                          orderAmount: "100.00"
                          orderCurrency: USD
                          txnAmount: "100.00"
                          txnCurrency: USD
                          arn: null
                          appId: replace_with_app_id
                          website: https://merchant.example.com
                          cardNumber: 370000******0002
                          holderName: Example Cardholder
                          eci: null
                          email: customer@example.com
                          channelRequestId: replace_with_channel_request_id
                          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
                      current: "1"
                      size: 10
                      totalPages: 1
                      totalElements: 1
```