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

# Support Bins

> List available card types/BINs with pricing and features



## OpenAPI

````yaml post /api/v2.1/fincard/virtual/card/v2/cardTypes
openapi: 3.1.0
info:
  title: Business BFF API
  version: 1.0.0
  description: Backend for Frontend - Business Panels Orchestration Layer
servers:
  - url: https://sandbox.finhub.cloud
    description: Sandbox Environment
security: []
tags:
  - name: AML
    description: Anti-Money Laundering checks and transaction monitoring
  - name: Admin - Consent Management
    description: Operations for managing consent templates and definitions
  - name: B2B Customer - Organization
    description: B2B organization registration and management
  - name: B2C Customer - Individual
    description: Individual customer registration and lifecycle management
  - name: BFF Admin - Tenant Initialization
    description: Lazy tenant initialization for fast startup
  - name: Catalog Hierarchy
    description: Hierarchical catalog management APIs
  - name: Catalog-Process Mapping
    description: APIs for catalog-process relationship management
  - name: Consent
    description: Payment consent creation and approval
  - name: Draft Management
  - name: External Events
    description: Kafka-to-HTTP bridge event ingestion and query
  - name: FinCard Virtual - Webhooks
    description: FinCard Virtual Card Webhook receiver
  - name: FinCard Virtual Account
    description: FinCard Virtual Card Account API proxy
  - name: FinCard Virtual Card Holder
    description: FinCard Virtual Card Holder API proxy
  - name: FinCard Virtual Cards
    description: FinCard Virtual Card API proxy
  - name: FinCard Virtual Common
    description: FinCard Virtual Card Common API proxy
  - name: FinCard Virtual Wallet
    description: FinCard Virtual Card Wallet API v2 proxy
  - name: FinTrans - Operations
    description: Financial transaction operations
  - name: Internal Webhooks
    description: Internal service-to-service webhook trigger (HMAC-secured)
  - name: MFE Preload
    description: MFE preload endpoints for SSR optimization
  - name: MFE Registry
    description: MFE Registry management endpoints
  - name: Payment Consent Management
    description: Operations for managing payment consents and validation
  - name: Person
    description: Person details for process context
  - name: Products
    description: Product Catalog Management API
  - name: Reference Data
    description: Shared reference data (countries, etc.)
  - name: Tenant Lifecycle
    description: Tenant mode transitions and lifecycle management
  - name: Tenant Registration
    description: Self-registration and tenant onboarding
  - name: Transfers
    description: Transfer prepare/execute aliases for muse-proxy compatibility
  - name: Verification
    description: Customer verification (KYC/KYB/AML) management
  - name: Wallet
    description: Wallet operations and balance management
  - name: Webhooks
    description: Webhook subscription and delivery management
paths:
  /api/v2.1/fincard/virtual/card/v2/cardTypes:
    post:
      tags:
        - FinCard Virtual Cards
      summary: Support Bins
      description: List available card types/BINs with pricing and features
      parameters:
        - description: User agent
          name: User-Agent
          in: header
          schema:
            type: string
        - description: Forwarded for
          name: X-Forwarded-For
          in: header
          schema:
            type: string
        - $ref: '#/components/parameters/XForwardedFromHeader'
        - description: Tenant ID
          name: X-Tenant-ID
          in: header
          schema:
            type: string
        - description: Device ID
          name: deviceId
          in: header
          schema:
            type: string
        - description: Platform
          name: platform
          in: header
          schema:
            type: string
      requestBody:
        description: Empty request body
        content:
          application/json:
            schema:
              type: string
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CardTypesResponse'
        '400':
          description: Bad request
        '500':
          description: Internal server error
components:
  parameters:
    XForwardedFromHeader:
      name: X-Forwarded-From
      in: header
      required: true
      description: Client application identifier
      schema:
        type: string
        example: client-app
  schemas:
    CardTypesResponse:
      type: object
      description: Card types response
      properties:
        success:
          type: boolean
          examples:
            - true
          description: Success flag
          example: true
        code:
          type: integer
          format: int32
          examples:
            - 200
          description: Response code
          example: 200
        msg:
          type: string
          examples:
            - Success
          description: Response message
          example: Success
        data:
          type: array
          items:
            $ref: '#/components/schemas/CardTypeData'
          description: Card types data
    CardTypeData:
      type: object
      description: Card type/BIN information
      properties:
        cardTypeId:
          type: integer
          format: int64
          description: Card type id
        organization:
          type: string
          description: 'Card organization: Visa, MasterCard, Discover'
        country:
          type: string
          description: Issue country, e.g. US
        mode:
          type: string
          description: 'Card model: PREPAID_CARD, BUDGET_CARD'
        bankCardBin:
          type: string
          description: Card Bin, e.g. 531993
        type:
          type: string
          description: 'Card type: Virtual, Physical'
        category:
          type: string
          description: 'Card category: GIFT, PURCHASE, SUBSCRIPTION, PHYSICAL'
        cardName:
          type: string
          description: Card name
        cardDesc:
          type: string
          description: Card description
        cardPrice:
          type: number
          description: Card fee, e.g. 5
        cardPriceCurrency:
          type: string
          description: Card fee currency, e.g. USD
        support:
          type: array
          items:
            type: string
          description: Supporting merchant (reference only)
        risk:
          type: array
          items:
            type: string
          description: High risk merchant - triggers card cancellation risk control
        needCardHolder:
          type: boolean
          description: Cardholder is required
        supportHolderRegin:
          type: array
          items:
            type: string
          description: Supported nationality country/region codes (ISO 3166-1 alpha-2)
        supportHolderAreaCode:
          type: array
          items:
            type: string
          description: Supported mobile area codes
        needDepositForActiveCard:
          type: boolean
          description: Initial deposit required when creating card
        depositAmountMinQuotaForActiveCard:
          type: number
          description: Minimum initial deposit amount
        depositAmountMaxQuotaForActiveCard:
          type: number
          description: Maximum initial deposit amount
        fiatCurrency:
          type: string
          description: Card currency, e.g. USD
        balanceRetentionQuota:
          type: number
          description: Minimum balance to retain on withdrawal
        status:
          type: string
          description: 'Status: online, offline'
        rechargeCurrency:
          type: string
          description: Deposit currency
        rechargeMinQuota:
          type: number
          description: Minimum deposit amount
        rechargeMaxQuota:
          type: number
          description: Maximum deposit amount
        rechargeFeeRate:
          type: number
          description: Deposit fee rate (1=1%)
        rechargeFixedFee:
          type: number
          description: Fixed deposit fee
        rechargeDigital:
          type: integer
          format: int32
          description: Decimal point length for deposit amount
        enableActiveCard:
          type: boolean
          description: Enable create card function
        enableDeposit:
          type: boolean
          description: Enable deposit card function
        enableFreeze:
          type: boolean
          description: Enable freeze card function
        enableUnFreeze:
          type: boolean
          description: Enable unfreeze card function
        metadata:
          $ref: '#/components/schemas/CardTypeMetadata'
          type: object
          description: Metadata
    CardTypeMetadata:
      type: object
      description: Card type metadata
      properties:
        cardHolderMaxCardLimit:
          type: integer
          format: int32
          description: Maximum number of cards a cardholder can own
        cardHolderModel:
          type: string
          description: 'Cardholder model: B2B, B2C'
        supportSettingNoPinPaymentAmount:
          type: boolean
          description: Support setting password-free payment amount (physical)
        defaultNoPinPaymentAmount:
          type: number
          description: Default password-free payment amount (physical)
        noPinPaymentAmountMinQuota:
          type: number
          description: Min password-free payment amount (physical)
        noPinPaymentAmountMaxQuota:
          type: number
          description: Max password-free payment amount (physical)
        spendingControls:
          type: array
          items:
            $ref: '#/components/schemas/SpendingControl'
          description: Spending controls
        supportSettingMcc:
          type: boolean
          description: Support setting allowed/blocked MCC
    SpendingControl:
      type: object
      description: Spending control
      properties:
        interval:
          type: string
          description: 'Spending interval: PER_TRANSACTION'
        amount:
          type: number
          description: Spending amount
        supportSetting:
          type: boolean
          description: Support set spending

````