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

# Lister les cartes virtuelles

> Parcourez les cartes virtuelles de l'application sans exposer leurs données sensibles.

Cette liste ne contient ni PAN, ni CVV, ni code PIN. Utilisez le détail sensible uniquement au moment où l'utilisateur en a besoin.

```bash cURL theme={null}
curl --request GET \
  --url 'https://api.bizconnectpay.com/api/v1/cards?per_page=25' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <access_token>'
```

```json 200 OK theme={null}
{
  "success": true,
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": "3b2c08e5-d8f2-4886-aad1-88977d455ff8",
        "virtual_card_customer_id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
        "provider_reference": "38537f3f-3948-43af-fd9d-08df17dfe646",
        "issuance_reference": "card-issuance-2026-001",
        "issuance_fee_usd": "3.30000000",
        "exchange_rate": "606.060000000000",
        "charged_amount": "2000.00000000",
        "charged_currency": "XAF",
        "environment": "LIVE",
        "card_sequence": 1,
        "created_at": "2026-10-20T14:10:00.000000Z"
      }
    ],
    "per_page": 25,
    "total": 1
  },
  "meta": {
    "correlation_id": "f9c35025-8a46-4238-982c-f4076c65ca47"
  }
}
```


## OpenAPI

````yaml openapi.json GET /cards
openapi: 3.1.0
info:
  title: BizConnectPay API
  version: 1.0.0
  description: >-
    API serveur-à-serveur pour les collectes, décaissements, transactions,
    remboursements, liens de paiement et cartes virtuelles.
servers:
  - url: https://api.bizconnectpay.com/api/v1
    description: Passerelle API BizConnectPay
security:
  - bearerAuth: []
tags:
  - name: Authentification
  - name: Services
  - name: Collectes
  - name: Transactions
  - name: Décaissements
  - name: Remboursements
  - name: Liens de paiement
  - name: Porteurs de carte
  - name: Cartes virtuelles
paths:
  /cards:
    get:
      tags:
        - Cartes virtuelles
      summary: Lister les cartes virtuelles
      operationId: listVirtualCards
      parameters:
        - $ref: '#/components/parameters/PerPage'
      responses:
        '200':
          $ref: '#/components/responses/Success'
components:
  parameters:
    PerPage:
      name: per_page
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 25
  responses:
    Success:
      description: Requête traitée
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SuccessEnvelope'
  schemas:
    SuccessEnvelope:
      type: object
      properties:
        success:
          type: boolean
          const: true
        data: {}
        meta:
          $ref: '#/components/schemas/Meta'
    Meta:
      type: object
      properties:
        correlation_id:
          type:
            - string
            - 'null'
          format: uuid
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.