> ## 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.

# Consulter une carte virtuelle

> Récupérez les données à jour et les transactions d'une carte.

> [!WARNING]
>
> Cette réponse peut contenir le PAN, le CVV et le code PIN. Ne la journalisez pas, ne la mettez pas en cache et ne la conservez pas dans votre base de données.

```bash cURL theme={null}
curl --request GET \
  --url https://api.bizconnectpay.com/api/v1/cards/3b2c08e5-d8f2-4886-aad1-88977d455ff8 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <access_token>'
```

```json 200 OK theme={null}
{
  "success": true,
  "data": {
    "card": {
      "id": 636,
      "balance": 2.0,
      "currency": "USD",
      "card_id": "38537f3f-3948-43af-fd9d-08df17dfe646",
      "card_pan": "4288520000003108",
      "masked_pan": "428852******3108",
      "cvv": "813",
      "expired_at": "09 / 2029",
      "card_type": "Visa",
      "pin": 218360,
      "active": true,
      "disabled": false,
      "status": "PAID",
      "category": "BUSINESS",
      "grade": "PREMIUM",
      "virtual_card_user": {
        "reference": "BCP-CUS-67804B24CF5D3",
        "first_name": "Amina",
        "last_name": "Ndiaye",
        "email": "amina@example.com"
      }
    },
    "transactions": [
      {
        "id": 132923,
        "date": "2026-09-21T17:41:25.000Z",
        "merchant": {
          "name": "Example Software",
          "city": "",
          "country": "USA"
        },
        "status": "successful",
        "currency": "USD",
        "amount": "20",
        "type": "debit",
        "transactionType": "purchase"
      }
    ]
  },
  "meta": {
    "correlation_id": "f9c35025-8a46-4238-982c-f4076c65ca47"
  }
}
```


## OpenAPI

````yaml openapi.json GET /cards/{virtualCard}
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/{virtualCard}:
    get:
      tags:
        - Cartes virtuelles
      summary: Consulter le détail sensible d'une carte
      description: >-
        Retourne les données en temps réel du fournisseur et l'historique. Scope
        requis : `virtual_cards.cards.sensitive.read`. La réponse ne doit jamais
        être mise en cache ou journalisée.
      operationId: getVirtualCard
      parameters:
        - name: virtualCard
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    Success:
      description: Requête traitée
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SuccessEnvelope'
    NotFound:
      description: Ressource introuvable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  schemas:
    SuccessEnvelope:
      type: object
      properties:
        success:
          type: boolean
          const: true
        data: {}
        meta:
          $ref: '#/components/schemas/Meta'
    ErrorEnvelope:
      type: object
      properties:
        success:
          type: boolean
          const: false
        data:
          type: object
          properties:
            error:
              type: object
              properties:
                code:
                  type: string
                message:
                  type: string
                details:
                  type:
                    - object
                    - array
        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.