Configuration
1.OBTENIR VOS IDENTIFIANTS BRIDGE
Étapes
- Connectez-vous à votre tableau de bord Bridge : https://dashboard.bridgeapi.io/
- Allez dans Settings → API
- Générez ou récupérez vos identifiants :
- Client ID (identifiant public)
- Client Secret (clé secrète - à ne jamais partager)
- Notez ces informations dans un lieu sûr
2.ACCÉDER À LA CONFIGURATION DU MODULE
⚠ Permissions requises : Vous devez avoir les permissions "Accès aux menus InfraS2Bridge" ET "Accès aux paramètres du module"
3.PARAMÈTRES BRIDGE (OBLIGATOIRES)
Client ID Bridge | Collez votre Client ID obtenu depuis le tableau de bord Bridge.
|
Client Secret Bridge | Collez votre Client Secret obtenu depuis le tableau de bord Bridge.
|
Secret Webhook | Le secret utilisé pour signer les webhooks.
|
URL Webhook | Générée automatiquement par le module. Copiez cette URL, vous en aurez besoin pour configurer Bridge. Format :
|
4.PARAMÈTRES DE PAIEMENT
Montant minimum de paiement | Valeur : Montant en € (ex : 10.00) Objectif : Empêcher la création de liens pour des petits montants Recommandation : 5 à 10 € Comportement : Les factures d'un montant inférieur ne généreront pas de lien |
Délai de révocation automatique | Valeur : Nombre de jours (entre 1 et 60) Objectif : Supprimer automatiquement les liens non utilisés Recommandation : 30 jours Comportement : Un lien créé depuis X jours sans paiement sera révoqué automatiquement |
Mode de règlement associé | Valeur : Sélectionner dans la liste déroulante Objectif : Seules les factures avec ce mode génèrent un lien Recommandation : Créez un mode "Bridge" ou "Paiement en ligne" Configuration du mode : Accueil → Configuration → Dictionnaires → Modes de règlement |
5.OPTIONS D'AFFICHAGE
Afficher le lien de paiement dans les factures | Valeur : Oui / Non Objectif : Afficher le lien cliquable sur la fiche facture Recommandation : Oui |
Afficher le QR code dans les factures | Valeur : Oui / Non Objectif : Afficher un QR code scannable Recommandation : Oui (pratique pour paiements mobiles) |
Ne pas mettre à jour la facture lors du paiement | Valeur : Oui / Non Objectif : Désactiver la création automatique de paiements Recommandation : Non (laisser l'automatisation activée) Usage : Activez si vous utilisez Banking4Dolibarr ou souhaitez un contrôle manuel |
6.CONFIGURER LE WEBHOOK DANS BRIDGE
Étapes détaillées
- Connectez-vous au tableau de bord Bridge
- Allez dans Settings → Webhooks
- Cliquez sur "Add Webhook"
- Renseignez :
- URL : Collez l'URL générée par le module Dolibarr
- Secret : Générez un secret (Bridge le fait automatiquement)
- Events : Sélectionnez
payment.completed
- Cliquez sur "Create"
- IMPORTANT : Copiez le secret généré
- Retournez dans Dolibarr et collez ce secret dans le champ "Secret Webhook"
- Testez le webhook depuis Bridge (bouton "Test")
✓ Test réussi : Si le test est réussi, Bridge affichera "200 OK". Votre configuration est correcte !
7.SAUVEGARDE ET RESTAURATION
Sauvegarder la configuration
En bas de la page de configuration, cliquez sur "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
En bas de la page, cliquez sur "Restaurer", sélectionnez votre fichier JSON et validez.
