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

# Connecter une session WhatsApp

> Initialisez l'appairage WhatsApp par QR Code ou par code de jumelage à 8 chiffres via la passerelle Baileys.

Deux modes d'authentification sont supportés :

* `QR` : Retourne un `qr_data_url` (Data URL image base64) à afficher pour scan depuis WhatsApp (*Appareils connectés > Connecter un appareil*).
* `PAIRING_CODE` : Retourne un code à 8 chiffres (`pairing_code`, ex: `4892-7104`) à saisir dans WhatsApp sans appareil photo.

```bash cURL (Scan QR Code) theme={null}
curl --request POST \
  --url https://api.bizconnectpay.com/api/v1/whatsapp/session/connect \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "mode": "QR"
  }'
```

```bash cURL (Code de jumelage) theme={null}
curl --request POST \
  --url https://api.bizconnectpay.com/api/v1/whatsapp/session/connect \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "mode": "PAIRING_CODE",
    "phone_number": "+237699001122"
  }'
```

```json 200 OK (QR Code) theme={null}
{
  "success": true,
  "data": {
    "status": "QR_READY",
    "qr_data_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "mode": "QR"
  },
  "meta": {
    "correlation_id": "84a30e20-7f28-4859-ae94-3965b1b4689b"
  }
}
```

```json 200 OK (Code de jumelage) theme={null}
{
  "success": true,
  "data": {
    "status": "PAIRING_CODE_READY",
    "pairing_code": "4892-7104",
    "mode": "PAIRING_CODE"
  },
  "meta": {
    "correlation_id": "84a30e20-7f28-4859-ae94-3965b1b4689b"
  }
}
```


## OpenAPI

````yaml openapi.json POST /whatsapp/session/connect
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
  - name: Notifications
paths:
  /whatsapp/session/connect:
    post:
      tags:
        - Notifications
      summary: Connecter une session WhatsApp (Baileys)
      description: >-
        Génère un QR Code ou un code de jumelage à 8 chiffres pour lier un
        numéro WhatsApp d'entreprise ou individuel au worker Baileys.
      operationId: connectWhatsAppSession
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WhatsAppConnectRequest'
      responses:
        '200':
          $ref: '#/components/responses/Success'
        '401':
          $ref: '#/components/responses/Unauthenticated'
components:
  schemas:
    WhatsAppConnectRequest:
      type: object
      properties:
        mode:
          type: string
          enum:
            - QR
            - PAIRING_CODE
          default: QR
        phone_number:
          type: string
          description: Numéro international si mode=PAIRING_CODE (+237...)
    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
  responses:
    Success:
      description: Requête traitée
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SuccessEnvelope'
    Unauthenticated:
      description: Authentification requise ou invalide
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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