Installation

Installation

Prérequis

Avant d'installer le module, vérifiez que votre environnement répond aux conditions suivantes :

  • Dolibarr version 18.0 (LTS) ou supérieure, testé jusqu'à la 23
  • PHP version 7.4 ou supérieure
  • Un compte Mollie actif (https://www.mollie.com)
  • Les modules Dolibarr Banque et Prélèvements activés
  • Un accès HTTPS à votre Dolibarr depuis Internet

Pourquoi HTTPS est obligatoire

Mollie n'envoie ses notifications (webhooks) qu'à une URL en https. Sans HTTPS, un paiement serait encaissé chez Mollie sans que rien ne vienne l'enregistrer dans Dolibarr.

Le module refuse donc de démarrer un paiement si l'URL de votre Dolibarr ($dolibarr_main_url_root dans conf.php) ne commence pas par https. Un bandeau d'avertissement s'affiche en haut de la page Configuration > Mollie > Paramètres.

Installation des fichiers

  1. Téléchargez l'archive du module depuis le DoliStore ou votre source habituelle
  2. Décompressez l'archive
  3. Copiez le dossier mollie dans le répertoire htdocs/custom/ de votre installation Dolibarr

La structure attendue est :

htdocs/custom/mollie/
├── admin/
├── class/
├── core/
├── langs/
├── lib/
├── public/
├── sql/
└── ...

Activation du module

  1. Rendez-vous dans Accueil > Configuration > Modules
  2. Recherchez Mollie dans la liste des modules (catégorie "Interfaces")
  3. Cliquez sur le bouton d'activation

Page d'activation du module Mollie dans la liste des modules Dolibarr

Actions automatiques à l'activation

Lors de l'activation, le module effectue automatiquement les actions suivantes :

  • Création d'un compte bancaire "MOLLIE" dans Dolibarr, dédié au stockage des transactions Mollie
  • Génération d'un jeton de sécurité pour les pages publiques (paiement, IBAN)
  • Enregistrement des tâches planifiées (désactivées par défaut)
  • Création des tables SQL nécessaires au fonctionnement du module

Vérification post-installation

Après l'activation :

  1. Vérifiez que le sous-menu Mollie apparaît dans le menu Banque
  2. Accédez à Configuration > Mollie > Paramètres pour renseigner vos clés API
  3. Renseignez l'utilisateur pour les actions : sans lui, le module refuse d'enregistrer les paiements reçus par webhook (voir Configuration)
  4. Vérifiez qu'aucun bandeau rouge d'avertissement HTTPS ne s'affiche en haut de la page
  5. Consultez la page Configuration pour le paramétrage complet

Jeton de sécurité des pages publiques

Le module génère à l'activation la constante PAYMENT_SECURITY_TOKEN si elle n'existe pas. Elle protège les pages publiques de paiement et le lien de création de mandat SEPA.

Si cette constante est vide (Configuration > Divers), le lien de mandat SEPA n'est plus généré du tout et un message le signale à la place du lien. Renseignez-la avec une valeur longue et aléatoire.

Conseil : Commencez par le mode test en utilisant votre clé API de test (test_xxxx). Vous pourrez passer en production une fois l'intégration validée.

Mise à jour

Pour mettre à jour le module :

  1. Remplacez le contenu du dossier htdocs/custom/mollie/ par la nouvelle version
  2. Rendez-vous dans Accueil > Configuration > Modules
  3. Désactivez puis réactivez le module pour appliquer les migrations SQL

Si un message d'avertissement indique une incohérence entre la version du module et la base de données, désactivez et réactivez le module pour résoudre le problème.

Module Mollie Configuration