--- title: "FAQ" weight: 95 description: "Réponses aux questions fréquentes sur l'utilisation du module Mollie pour Dolibarr." --- # FAQ ## Général **Q : Quels modules Dolibarr sont nécessaires ?** Les modules **Banque** et **Prélèvements** doivent être activés avant d'activer le module Mollie. **Q : Quelle version de Dolibarr faut-il ?** Dolibarr **18.0 (LTS)** au minimum. Le module est testé jusqu'à la version 23. **Q : Mon Dolibarr doit-il être en HTTPS ?** Oui, c'est obligatoire. Mollie ne notifie que des URL en `https` : sans cela un paiement serait encaissé sans que rien ne l'enregistre dans Dolibarr. Le module refuse donc de démarrer un paiement et affiche un bandeau d'avertissement dans sa configuration. **Q : Le module fonctionne-t-il avec le multi-entité ?** Oui, le module est compatible multi-entité. Chaque entité peut avoir ses propres clés API et sa propre configuration. ## Configuration **Q : Comment obtenir mes clés API Mollie ?** Connectez-vous à votre tableau de bord Mollie (), allez dans **Développeurs > Clés API**. Vous y trouverez votre clé de test et votre clé de production. **Q : Puis-je tester sans risque ?** Oui, laissez le mode production décoché dans les paramètres. En mode test, toutes les transactions sont simulées. Utilisez la clé API de test (`test_xxxx`). **Q : Comment passer en production ?** 1. Vérifiez que votre intégration fonctionne en mode test 2. Renseignez votre clé API de production (`live_xxxx`) 3. Cochez la case **Passage en production** 4. Utilisez le bouton **Nettoyer les données de test** pour supprimer les comptes de test ## Paiements **Q : Les paiements se mettent-ils à jour automatiquement ?** Oui, via deux mécanismes : - Les **webhooks** Mollie notifient Dolibarr en temps réel - La **tâche planifiée** quotidienne vérifie les statuts comme filet de sécurité **Q : Que se passe-t-il si un webhook échoue ?** Le webhook est enregistré dans le journal avec le statut "Échoué" et le message d'erreur. Si la cause est temporaire (base occupée, paramètre non encore renseigné), le module répond un code 500 : Mollie redélivre la notification pendant 26 heures, et le paiement finit par être enregistré. Si le paiement ne peut pas correspondre à son objet (devise ou montant différent), le module répond 200 pour ne pas boucler et la notification reste à examiner. La tâche planifiée quotidienne rattrape également les paiements manqués et rejoue les webhooks restés en échec. **Q : Pourquoi le module refuse-t-il de démarrer un paiement ?** Les cas les plus fréquents : - la facture est déjà soldée, avoirs et acomptes compris - la facture est en brouillon, annulée ou abandonnée - la commande a déjà été transformée en facture - votre Dolibarr n'est pas accessible en HTTPS La raison exacte est écrite dans les logs Dolibarr et un message s'affiche au client. **Q : Un client a quitté la page de paiement, peut-il revenir payer ?** Oui. S'il revient alors que la session de paiement Mollie est encore ouverte, il retrouve la même page. Si elle a expiré ou échoué, un nouveau paiement est créé automatiquement. Si le paiement a en fait abouti, un message l'invite à vous contacter plutôt que de payer deux fois. **Q : Un paiement affiche "en cours de confirmation", est-ce normal ?** Oui, pour un virement bancaire ou un paiement en plusieurs fois. Mollie n'a pas encore confirmé l'encaissement. Le règlement sera enregistré dans Dolibarr dès la confirmation, sans action de votre part. **Q : Comment annuler un paiement ?** Depuis la fiche du paiement, cliquez sur **Annuler**. Cette action n'est possible que pour les paiements en attente qui supportent l'annulation. ## Prélèvements SEPA **Q : Comment mettre en place un prélèvement SEPA pour un client ?** 1. Créez un **client** Mollie (ou liez un client existant à un tiers Dolibarr depuis l'onglet Mollie de sa fiche) 2. Communiquez le **lien de création de mandat** à votre client (disponible dans l'onglet Mollie de la fiche tiers). Le client y saisit son IBAN et le mandat est créé via l'API Mollie. 3. Une fois le mandat actif, les factures dont le mode de paiement est "Prélèvement" (PRE) et le compte bancaire est le compte Mollie afficheront un bouton **Prélèvement SEPA par Mollie** qui lance le prélèvement en un clic. **Q : Comment fonctionne le bouton SEPA sur les factures ?** Le bouton apparaît sur les factures validées dont le mode de paiement est "PRE" et le compte bancaire est le compte Mollie. Si le client a un mandat SEPA actif, le prélèvement est lancé directement. Sinon, une popup affiche le lien à communiquer au client pour qu'il crée son mandat. **Q : Que faire si un mandat est invalide ?** Un mandat peut devenir invalide si le client le révoque auprès de sa banque. Dans ce cas, communiquez-lui à nouveau le lien de création de mandat depuis l'onglet Mollie de sa fiche tiers. **Q : Le prélèvement automatique concerne-t-il toutes les factures ?** La tâche planifiée **MollieCheckTakePayments** traite les factures impayées dont le mode de paiement est "prélèvement", le compte bancaire est le compte Mollie, et **dont le client possède un mandat valide** dans le module. Si vous souhaitez limiter les prélèvements aux factures liées à un contrat, activez l'option correspondante dans la configuration SEPA. Elle ne fonctionne qu'en mode production. **Q : Un client a signé son mandat en ligne mais n'est jamais prélevé** Vérifiez qu'il apparaît dans **Banque > Mollie > Mandats SEPA** avec le statut *Valide* et la méthode *directdebit*. La sélection des factures à prélever se fonde sur cette liste. **Q : Qui est le créancier SEPA dans le mandat ?** C'est **Mollie** qui est le créancier SEPA (ils utilisent leur propre numéro ICS). Mollie agit en tant que prestataire de paiement pour le compte de votre entreprise. Le mandat ne sera pas transférable si vous changez d'opérateur de paiement. ## Comptabilité **Q : Où sont enregistrées les transactions dans Dolibarr ?** Les transactions Mollie sont enregistrées dans le compte bancaire **MOLLIE** créé automatiquement à l'activation du module. Les reversements (virements de Mollie vers votre banque) sont visibles dans la section [Reversements](/mollie/paiements). **Q : Comment voir les frais Mollie ?** Les frais de commission sont disponibles dans **Factures Mollie** (voir [Factures de commission](/mollie/liens_factures)). Synchronisez régulièrement pour avoir les dernières factures. Les frais par transaction apparaissent dans la colonne **Frais** de la liste des paiements, une fois que Mollie a porté la transaction sur votre balance (voir [Paiements](/mollie/paiements)). **Q : Un remboursement crée-t-il l'avoir automatiquement ?** Non. Le module écrit la **ligne négative sur le compte bancaire Mollie**, car l'argent est réellement sorti, et pose un événement sur la facture avec la ligne à rapprocher. L'avoir reste à créer par vos soins : un remboursement partiel n'a pas de traduction comptable automatique. Même principe pour une contestation, avec une écriture de contrepartie si le litige est gagné. **Q : Une facture en devise étrangère est-elle encaissée dans la bonne devise ?** Oui, si le module multidevise est actif. Le client est débité du montant en devise de la facture, et le règlement est enregistré avec le taux de change de la facture. ## Dépannage **Q : La page "Compte" affiche "informations non disponibles"** Vérifiez que votre clé API est correctement renseignée dans les paramètres et que le mode (test/production) correspond à la clé utilisée. **Q : Les webhooks ne fonctionnent pas** Vérifiez que : - Votre serveur est accessible depuis Internet - L'URL `https://votre-dolibarr/custom/mollie/public/hook.php` répond correctement - Consultez le journal des [webhooks](/mollie/webhooks) pour identifier les erreurs - En mode test, utilisez un outil de tunnel (ngrok) si votre serveur est local **Q : La synchronisation échoue** Consultez les logs Dolibarr (`dolibarr_mollie.log`) pour identifier l'erreur. Les causes courantes sont : - Clé API invalide ou expirée - Limites de taux API atteintes (trop de requêtes) - Problème réseau **Q : Un message indique une incohérence de version** Désactivez puis réactivez le module depuis **Accueil > Configuration > Modules** pour appliquer les migrations de base de données.