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 (https://my.mollie.com), 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.

Q : Comment voir les frais Mollie ?

Les frais de commission sont disponibles dans Factures Mollie (voir Factures de commission). 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).

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