# 查询卡产品

> 查询商户可用的卡产品及相关配置。

```yaml
openapi: 3.1.0
info:
  title: 查询卡产品
  version: 1.0.0
  description: 查询商户可用的卡产品及相关配置。
paths:
  /api/v1/merchant/cardProduct/list:
    post:
      summary: 查询卡产品
      description: 查询商户可用的卡产品及相关配置。
      parameters:
        - name: ApiKey
          in: header
          required: true
          description: Onerway 分配的发卡 API key 请求 Header。
          schema:
            type: string
            description: Onerway 分配的发卡 API key 请求 Header。
      responses:
        "200":
          description: 返回卡产品列表
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 业务响应码；`20000` 表示成功。
                  respMsg:
                    type: string
                    description: 响应信息。
                  data:
                    type:
                      - array
                      - "null"
                    description: 商户可用的卡产品列表。
                    items:
                      type: object
                      properties:
                        productId:
                          type: integer
                          description: 卡产品 ID。
                        productName:
                          type: string
                          description: 卡产品名称。
                        cardBin:
                          type: string
                          description: 卡 BIN。
                        cardScheme:
                          type: string
                          description: 卡组织。
                        issueCurrency:
                          type: string
                          description: 发卡币种。
                        issueRegionCode:
                          type: string
                          description: 发卡地区代码。
                        cardholderConfig:
                          type:
                            - object
                            - "null"
                          properties:
                            maxCardCount:
                              type: integer
                              description: 单个持卡人允许持有的最大卡片数量。
                            requiredFields:
                              type: array
                              description: 使用此卡产品所需的持卡人字段。
                              items:
                                type: string
                              x-onerway-value:
                                empty: true
                                when:
                                  en: Returned as an empty array when no additional cardholder field is required.
                                  zh: 无需额外持卡人字段时返回空数组。
                          description: 卡产品的持卡人配置。
                          x-onerway-value:
                            nullable: true
                            when:
                              en: Returned as `null` when no cardholder configuration applies.
                              zh: 无持卡人配置时返回 `null`。
                        cardRechargeConfig:
                          type:
                            - object
                            - "null"
                          properties:
                            rechargeMinQuota:
                              type: number
                              description: 最低充值金额。
                            rechargeMaxQuota:
                              type: number
                              description: 最高充值金额。
                          description: 卡产品的充值配置。
                          x-onerway-value:
                            nullable: true
                            when:
                              en: Returned as `null` when no recharge configuration applies.
                              zh: 无充值配置时返回 `null`。
                        feeViews:
                          type:
                            - array
                            - "null"
                          description: 卡产品的费用展示信息。
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                description: 费用项名称。
                              value:
                                type: string
                                description: 格式化后的费用项值。
                          x-onerway-value:
                            nullable: true
                            empty: true
                            when:
                              en: Returned as `null` or an empty array when no fee information is available.
                              zh: 无费用信息时返回 `null` 或空数组。
                    x-onerway-value:
                      nullable: true
                      empty: true
                      when:
                        en: Returned as `null` when the query fails, or as an empty array when no card
                          product is available.
                        zh: 查询失败时返回 `null`；无可用卡产品时返回空数组。
              examples:
                success:
                  summary: 返回卡产品列表
                  value:
                    respCode: "20000"
                    respMsg: success
                    data:
                      - productId: 20001
                        productName: Example Virtual Card
                        cardBin: "411111"
                        cardScheme: VISA
                        issueCurrency: USD
                        issueRegionCode: US
                        cardholderConfig:
                          maxCardCount: 5
                          requiredFields:
                            - firstName
                            - lastName
                        cardRechargeConfig:
                          rechargeMinQuota: 10
                          rechargeMaxQuota: 10000
                        feeViews:
                          - name: setupFee
                            value: 10.00 USD
```