---
title: "Installation"
weight: 10
description: "Guide d'installation et d'activation du module Mollie pour Dolibarr."
---

# 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](screenshots/activation-module.webp)

## 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](/mollie/configuration))
4. Vérifiez qu'aucun bandeau rouge d'avertissement HTTPS ne s'affiche en haut de la page
5. Consultez la page [Configuration](/mollie/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.