# 3. CONFIGURATION INITIALE

# Configuration

#### **1.OBTENIR VOS IDENTIFIANTS BRIDGE**

***Étapes***

1. <span style="white-space: pre-wrap;">Connectez-vous à votre tableau de bord Bridge : </span>**https://dashboard.bridgeapi.io/**
2. <span style="white-space: pre-wrap;">Allez dans </span>**Settings → API**
3. Générez ou récupérez vos identifiants :
    - **Client ID**<span style="white-space: pre-wrap;"> (identifiant public)</span>
    - **Client Secret**<span style="white-space: pre-wrap;"> (clé secrète - </span>**à ne jamais partager**)
4. Sauvegardez ces informations dans un lieu sûr (portefeuille sécurisée, coffre fort éléctronique, etc)

#### **2.ACCÉDER À LA CONFIGURATION DU MODULE**

**Menu :**<span style="white-space: pre-wrap;"> </span>**Outils → InfraS-2 → InfraS2Bridge → Paramètres**

[![Conf.png](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/pfFKeSxQzue0lV2J-conf.png)](https://wiki.infras.fr/uploads/images/gallery/2026-02/scaled-1680-/pfFKeSxQzue0lV2J-conf.png)

**⚠ Permissions requises :** <span style="white-space: pre-wrap;">Vous devez avoir les permissions </span>**"Accès aux menus InfraS2Bridge"**<span style="white-space: pre-wrap;"> ET </span>**"Accès aux paramètres du module"**

#### **3.PARAMÈTRES BRIDGE (OBLIGATOIRES)**

<table id="bkmrk-client-id-bridgecoll" style="width: 100%; border-collapse: collapse; margin-top: 20px;"><colgroup><col style="width: 40%;"></col><col></col></colgroup><tbody><tr style="background-color: white;"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); vertical-align: top; width: 40%; font-weight: 600; color: rgb(3, 169, 244);"><span style="color: rgb(0, 0, 0); white-space: pre-wrap;">Client ID Bridge </span>**\[Ligne 1\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); vertical-align: top; color: rgb(102, 102, 102);">Collez votre Client ID obtenu depuis le tableau de bord Bridge.

- **Format :**<span style="white-space: pre-wrap;"> Chaîne alphanumérique</span>
- **Exemple :**`<span class="editor-theme-code"> abc123def456</span>`

</td></tr><tr style="background-color: rgb(249, 249, 249);"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); vertical-align: top; font-weight: 600; color: rgb(3, 169, 244);"><span style="color: rgb(0, 0, 0); white-space: pre-wrap;">Client Secret Bridge </span>**\[Ligne 2\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); vertical-align: top; color: rgb(102, 102, 102);">Collez votre Client Secret obtenu depuis le tableau de bord Bridge.

- **Sécurité :**<span style="white-space: pre-wrap;"> Cette valeur sera automatiquement chiffrée en base.</span>
- **Important :**<span style="color: rgb(224, 62, 45); white-space: pre-wrap;"> Ne partagez JAMAIS cette clé</span>.

</td></tr><tr style="background-color: white;"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); vertical-align: top; font-weight: 600; color: rgb(3, 169, 244);"><span style="color: rgb(0, 0, 0); white-space: pre-wrap;">Secret Webhook </span>**\[Ligne 4\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); vertical-align: top; color: rgb(102, 102, 102);">Le secret utilisé pour signer les webhooks.

- **Où le trouver :**<span style="white-space: pre-wrap;"> Dans Bridge, lors de la création du webhook</span>
- **Sécurité :**<span style="white-space: pre-wrap;"> Valeur également chiffrée en base</span>

</td></tr><tr style="background-color: rgb(249, 249, 249);"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); vertical-align: top; font-weight: 600; color: rgb(3, 169, 244);"><span style="color: rgb(0, 0, 0); white-space: pre-wrap;">URL Webhook </span>**\[Ligne 3\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); vertical-align: top; color: rgb(102, 102, 102);">**Générée automatiquement**<span style="white-space: pre-wrap;"> par le module. Copiez cette URL, vous en aurez besoin pour configurer Bridge.</span>

**Format :**

`<span class="editor-theme-code">https://votredomaine.com/custom/infras2bridge/public/ipn.php</span>`

</td></tr></tbody></table>

#### **4.PARAMÈTRES DE PAIEMENT**

<table id="bkmrk-optionobjectifrecomm" style="width: 100%; border-collapse: collapse; margin-top: 20px; font-family: Arial, sans-serif;"><colgroup><col></col><col></col><col style="width: 158px;"></col><col></col></colgroup><tbody><tr style="background-color: rgb(189, 196, 218); color: white; text-align: left;"><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Option**

</th><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Objectif**

</th><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Recommandation**

</th><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Comportement**

</th></tr><tr style="background-color: white;"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); font-weight: 600;"><span style="white-space: pre-wrap;">Montant minimum de paiement </span>**\[Ligne 5\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Empêcher la création de liens pour des petits montants

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">50 à 100 €

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Les factures d'un montant inférieur ne généreront pas de lien

</td></tr><tr style="background-color: rgb(249, 249, 249);"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); font-weight: 600;"><span style="white-space: pre-wrap;">Délai de révocation automatique </span>**\[Ligne 6\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Supprimer automatiquement les liens non utilisés

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">30 jours

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Un lien créé depuis X jours sans paiement sera révoqué automatiquement

</td></tr><tr style="background-color: white;"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); font-weight: 600;"><span style="white-space: pre-wrap;">Mode de règlement associé </span>

**\[Ligne 9\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Seules les factures avec ce mode génèrent un lien

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">"Virement Bancaire"

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Les factures sans ce mode de règlement ne génèrent pas de lien

</td></tr></tbody></table>

#### **5.OPTIONS D'AFFICHAGE**

<table id="bkmrk-optionvaleurobjectif" style="width: 100%; border-collapse: collapse; margin-top: 20px; font-family: Arial, sans-serif;"><colgroup><col style="width: 223px;"></col><col style="width: 97px;"></col><col style="width: 144px;"></col><col style="width: 144px;"></col><col></col></colgroup><tbody><tr style="height: 10px; background-color: rgb(189, 196, 218); color: white; text-align: left;"><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Option**

</th><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Valeur**

</th><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Objectif**

</th><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Recommandation**

</th><th style="padding: 12px; border: 1px solid rgb(221, 221, 221);">**Comportement**

</th></tr><tr style="height: 10px; background-color: white;"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); font-weight: 600;"><span style="white-space: pre-wrap;">Afficher le lien de paiement dans les factures </span>**\[Ligne 7\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Oui / Non

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Afficher le lien cliquable sur la fiche facture

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Oui

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Si activé, le lien Bridge sera visible directement sur la facture

</td></tr><tr style="background-color: rgb(249, 249, 249);"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); font-weight: 600;"><span style="white-space: pre-wrap;">Afficher le QR code dans les factures </span>**\[Ligne 8\]**

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Oui / Non

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Afficher un QR code scannable

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Oui

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Permet aux clients de payer rapidement via un smartphone

</td></tr><tr style="background-color: white;"><td style="padding: 15px; border: 1px solid rgb(221, 221, 221); font-weight: 600;">Ne pas mettre à jour la facture lors du paiement

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Oui / Non

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Désactiver la création automatique de paiements

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Non

</td><td style="padding: 15px; border: 1px solid rgb(221, 221, 221);">Activez seulement si vous souhaitez gérer les paiements manuellement (ex: Banking4Dolibarr)

</td></tr></tbody></table>

#### **6.CONFIGURER LE WEBHOOK DANS BRIDGE**

***Étapes détaillées***

1. 1. Connectez-vous au tableau de bord Bridge
    2. <span style="white-space: pre-wrap;">Allez dans </span>**Settings → Webhooks**
    3. <span style="white-space: pre-wrap;">Cliquez sur </span>**"Add Webhook"**
    4. Renseignez :
        - - - **Events :**<span style="white-space: pre-wrap;"> Sélectionnez </span>`<span class="editor-theme-code">payment.completed</span>`
                - **URL :**<span style="white-space: pre-wrap;"> Collez l'URL générée par le module </span>***Dolibarr***
                - **Secret :**<span style="white-space: pre-wrap;"> Générez un secret (Bridge le fait automatiquement)</span>
    5. <span style="white-space: pre-wrap;">Cliquez sur </span>**"**Create**"**
    6. **IMPORTANT :**<span style="white-space: pre-wrap;"> Copiez le secret généré</span>
    7. <span style="white-space: pre-wrap;">Retournez dans </span>***Dolibarr***<span style="white-space: pre-wrap;"> et collez ce secret dans le champ </span>**"Secret Webhook"**
    8. Testez le webhook depuis Bridge (bouton "Test")

**✓ Test réussi :**<span style="white-space: pre-wrap;"> Si le test est réussi, Bridge affichera "200 OK". Votre configuration est correcte !</span>

#### **7.SAUVEGARDE ET RESTAURATION**

***Sauvegarder la configuration***

<span style="white-space: pre-wrap;">En haut de la page de configuration, cliquez sur </span>**"Sauvegarder"**. Un fichier JSON sera téléchargé contenant tous vos paramètres (sauf les secrets pour des raisons de sécurité).

***Restaurer une configuration***

<span style="white-space: pre-wrap;">En haut de la page, cliquez sur </span>**"Restaurer"**, sélectionnez votre fichier JSON et validez.