> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Card Products

> 返回签发产品对象的列表。



## OpenAPI

````yaml /zh/card-issuance/v1.6/issuing.yaml get /v1/issuing/products
openapi: 3.0.2
info:
  title: Issuing API
  version: 0.0.1
  x-source-en-commit: fdf4a2b
  x-source-en-path: card-issuance/v1.6/issuing.yaml
  description: >
    UQPAY Issuing API 让你签发虚拟卡、管理持卡人，并监控卡交易。


    ## 功能概览

    - 创建并管理虚拟卡（签发、激活、冻结、注销）

    - 通过 KYC 完成持卡人入驻与验证

    - 设置消费限额与卡控制

    - 为卡余额充值与提现

    - 查询卡交易与账户余额

    - 在发卡账户之间转账

    - 生成并下载报表


    ## 身份认证

    所有请求都需要携带有效的鉴权 Token，Token 通过 [Access
    Token](/zh/account-center/v1.6/api-reference/access-token) 接口获取。请在
    `x-auth-token` 请求头中携带该 Token。


    ## 幂等性

    POST 请求支持 `x-idempotency-key` 请求头，可安全重试而不会创建重复资源。
  contact:
    name: UQPAY Support Team
    url: https://www.uqpay.com/support
    email: support@uqpay.com
  license:
    name: Proprietary
    url: https://www.uqpay.com/legal/api-terms
  termsOfService: https://www.uqpay.com/legal/terms
  x-api-id: uqpay-issuing-api-v1.6.0
  x-categories:
    - Card Issuing
    - Transaction Processing
  x-features:
    - Virtual Card Issuance
    - Real-time Processing
    - Webhook Notifications
    - Comprehensive Reporting
    - Transaction Monitoring
servers:
  - url: https://api-sandbox.uqpaytech.com/api
    description: 沙盒环境基础 URL。
  - url: https://api.uqpay.com/api
    description: 生产环境基础 URL。
security: []
tags:
  - name: Card Lifecycle
    description: 创建卡片并管理其完整生命周期——签发、查询、更新、激活、绑定与变更状态。
  - name: Card Secure Data
    description: 通过 PCI 合规接口或令牌化 iframe 访问敏感卡数据（PAN、CVV）。是否可用取决于你的 PCI 状态，而非卡产品。
  - name: Card Funding
    description: 为预付类卡片充值或提取其卡内储值余额。
  - name: Card PIN
    description: 设置并管理卡片 PIN 码。`reset-pin` 用于实体卡，`manage-card-pin` 用于虚拟卡。
  - name: Card Add-ons
    description: >-
      产品专属的卡功能。每个操作仅适用于特定卡产品——参见
      [卡产品](/zh/card-issuance/v1.6/guide/card-products)。
  - name: Card Arts
    description: >-
      管理发卡账户可用的视觉设计（卡面）。可设置账户级默认卡面，或在签发/更新卡片时传入 `card_art_id` 以按卡覆盖。仅 Personal
      Visa 支持。
  - name: Cardholders
    description: 你可以创建持卡人。持卡人是你企业的授权代表，可被签发卡片。
  - name: Transactions
    description: 这些接口用于查询在你用户卡片上发生的交易信息。
  - name: Products
    description: 通过这组接口，你可以为客户创建卡订单。
  - name: Balances
    description: 各币种的可用金额与待处理金额会进一步按资金来源类型细分。你可以查询它，查看发卡账户当前的余额。
  - name: Transfers
    description: 在发卡账户之间转账。
  - name: Reports
    description: 生成并下载发卡报表。
  - name: Simulator
    description: 在沙盒环境中模拟卡交易。
paths:
  /v1/issuing/products:
    get:
      tags:
        - Products
      summary: List Card Products
      description: 返回签发产品对象的列表。
      operationId: list-card-products
      parameters:
        - $ref: '#/components/parameters/XOnBehalfOf'
        - $ref: '#/components/parameters/PageSize'
        - $ref: '#/components/parameters/PageNumber'
      responses:
        '200':
          description: 成功返回产品。
          headers:
            x-response-id:
              $ref: '#/components/headers/XResponseId'
          content:
            application/json:
              schema:
                title: ListProductsResponse
                properties:
                  total_pages:
                    $ref: '#/components/schemas/TotalPages'
                  total_items:
                    $ref: '#/components/schemas/TotalItems'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CardProductsResponse'
              example:
                total_pages: 1
                total_items: 2
                data:
                  - product_id: 467e993f-317a-49fc-9ea0-bf49de7d1f76
                    mode_type: SHARE
                    card_bin: '40963608'
                    card_form:
                      - VIR
                      - PHY
                    max_card_quota: 100
                    card_scheme: VISA
                    no_pin_payment_amount:
                      - currency: USD
                        amount: '2000'
                      - currency: SGD
                        amount: '2600'
                    card_currency:
                      - USD
                      - SGD
                    create_time: '2025-10-10T17:36:26+08:00'
                    update_time: '2026-01-14T15:34:57+08:00'
                    product_status: ENABLED
                    required_fields:
                      - name: first_name
                        type: string
                        required: true
                      - name: last_name
                        type: string
                        required: true
                      - name: email
                        type: string
                        required: true
                      - name: country_code
                        type: string
                        required: true
                      - name: date_of_birth
                        type: string
                        required: true
                      - name: phone_number
                        type: string
                        required: true
                  - product_id: ee1598df-dff3-4d74-98a0-e219ab9d4320
                    mode_type: SHARE
                    card_bin: '539578'
                    card_form:
                      - VIR
                    max_card_quota: 3000
                    card_scheme: MASTERCARD
                    no_pin_payment_amount:
                      - currency: USD
                        amount: '2000'
                      - currency: SGD
                        amount: '2600'
                    card_currency:
                      - USD
                      - SGD
                    create_time: '2025-10-20T16:29:34+08:00'
                    update_time: '2025-10-20T16:34:54+08:00'
                    product_status: ENABLED
                    required_fields:
                      - name: first_name
                        type: string
                        required: true
                      - name: last_name
                        type: string
                        required: true
                      - name: email
                        type: string
                        required: true
                      - name: country_code
                        type: string
                        required: true
                      - name: date_of_birth
                        type: string
                        required: true
                      - name: phone_number
                        type: string
                        required: true
                      - name: gender
                        type: string
                        required: true
                      - name: nationality
                        type: string
                        required: true
                      - name: identity
                        type: object
                        required: true
                        fields:
                          - name: type
                            type: string
                            required: true
                          - name: number
                            type: string
                            required: true
                          - name: front_file
                            type: string
                            required: true
                          - name: back_file
                            type: string
                            required: false
                          - name: hand_file
                            type: string
                            required: false
                      - name: residential_address
                        type: object
                        required: true
                        fields:
                          - name: country
                            type: string
                            required: true
                          - name: state
                            type: string
                            required: true
                          - name: city
                            type: string
                            required: true
                          - name: district
                            type: string
                            required: false
                          - name: line1
                            type: string
                            required: true
                          - name: line2
                            type: string
                            required: false
                          - name: line_en
                            type: string
                            required: true
                          - name: postal_code
                            type: string
                            required: false
      security:
        - XAuthToken: []
components:
  parameters:
    XOnBehalfOf:
      in: header
      name: x-on-behalf-of
      schema:
        type: string
      required: false
      description: >
        指定代表哪个子账户发起请求。应设置为 `account_id`，该值可通过 [List Connected
        Accounts](/zh/account-center/v1.6/api-reference/list-connected-accounts)
        接口获取。若省略或为空，则请求以主账户身份执行。

        更多信息参见 [关联账户](/zh/account-center/v1.6/guide/connected-accounts)。
      example: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be
    PageSize:
      name: page_size
      description: 每页返回的最大条目数。取值范围为 10 - 100，默认为 10。
      in: query
      required: true
      schema:
        type: integer
        minimum: 10
        maximum: 100
        default: 10
    PageNumber:
      name: page_number
      description: 用于获取下一组条目的页码。取值必须大于 1，默认为 1。
      in: query
      required: true
      schema:
        type: integer
        minimum: 1
        default: 1
  headers:
    XResponseId:
      description: 响应的全局唯一标识符（UUID v4）。在联系 UQPAY 支持团队时有助于定位某次请求。
      schema:
        type: string
        format: uuid
        example: 2adba88e-9d63-44bc-b975-9b6ae3440dde
  schemas:
    TotalPages:
      type: integer
      example: 1
      description: 可用条目的总页数。
    TotalItems:
      type: integer
      example: 10
      description: 可用条目的总数。
    CardProductsResponse:
      type: object
      required:
        - product_id
        - card_bin
        - card_type
        - card_mode
        - card_scheme
        - create_time
        - update_time
        - product_status
        - no_pin_payment_amount
        - card_form
        - card_currency
      properties:
        product_id:
          $ref: '#/components/schemas/CardId'
        mode_type:
          $ref: '#/components/schemas/ModeType'
        card_bin:
          $ref: '#/components/schemas/CardBin'
        card_form:
          description: |
            表示当前账户下该产品支持的卡形态。
            以数组形式返回：
            - `VIR` 代表虚拟卡。
            - `PHY` 代表实体卡。
          type: array
          items:
            type: string
          example:
            - VIR
        max_card_quota:
          type: integer
          description: |
            当前账户下该产品可签发的最大卡片数量。
          example: 100
        card_scheme:
          $ref: '#/components/schemas/CardScheme'
        no_pin_payment_amount:
          $ref: '#/components/schemas/NoPINPaymentAmountArrayInResponse'
        card_currency:
          type: array
          items:
            type: string
          example:
            - SGD
            - USD
          description: 指定使用该产品可签发卡片的币种。以字符串数组形式返回。
        create_time:
          description: 对象的创建时间。
          type: string
          example: '2023-09-15T10:02:17+08:00'
        update_time:
          description: 对象的更新时间。
          type: string
          example: '2023-09-15T10:02:17+08:00'
        product_status:
          type: string
          example: ENABLED
          description: |
            产品状态 - `ENABLED` 或 `DISABLED` 之一。
            此字段为必填，且必须是以下之一：
              * `ENABLED` - 产品已启用。
              * `DISABLED` - 产品已禁用。
        required_fields:
          type: array
          description: 该产品的卡 BIN 为 KYC 验证所需的持卡人字段列表。配置后返回。
          items:
            $ref: '#/components/schemas/ProductRequiredField'
    CardId:
      type: string
      example: c0cef051-29c5-4796-b86a-cd5b684bfad7
      description: 卡片的唯一标识符。
    ModeType:
      type: string
      example: SHARE
      enum:
        - SHARE
        - SINGLE
      description: |
        模式类型枚举 - SINGLE 或 SHARE。

          * `SINGLE` - 单卡仅支持预付模式。
          * `SHARE` - 共享卡可支持借记模式，即关联借记产品和账户。
    CardBin:
      type: string
      example: '40963608'
      description: 卡号前缀（BIN）。
    CardScheme:
      type: string
      example: VISA
      description: 卡组织。
    NoPINPaymentAmountArrayInResponse:
      type: array
      description: |
        各币种下免密卡交易的最大允许金额。
        数组中的每一项代表当前卡产品下，某一币种可配置的免密支付上限。
      items:
        type: object
        required:
          - amount
          - currency
        properties:
          amount:
            type: string
            description: 免密支付金额。
            example: '2000'
          currency:
            type: string
            description: ISO 4217 货币代码（如 USD、SGD）。
            example: USD
    ProductRequiredField:
      type: object
      description: 卡 BIN 为持卡人 KYC 所需的字段。当 `type` 为 `object` 时，`fields` 数组描述其子字段。
      properties:
        name:
          type: string
          description: 字段名称。
          example: identity
        type:
          type: string
          description: 字段数据类型：`string` 或 `object`。
          example: object
        required:
          type: boolean
          description: 该字段是否必填。
          example: true
        description:
          type: string
          description: 字段的可读描述。
          example: Identity document information
        fields:
          type: array
          description: 当 `type` 为 `object` 时的子字段。结构与父级 `required_fields` 项相同。
          items:
            $ref: '#/components/schemas/ProductRequiredField'
  securitySchemes:
    XAuthToken:
      type: apiKey
      in: header
      name: x-auth-token
      description: 由 UQPay 提供的登录 API Token。

````