---
title: "Paiements et reversements"
weight: 30
description: "Gestion des transactions de paiement et des reversements (virements de Mollie vers votre compte bancaire)."
---

# Paiements et reversements

## Paiements

Accès : **Banque > Mollie > Paiements**

Les paiements représentent les transactions effectuées par vos clients via Mollie (carte bancaire, iDEAL, Bancontact, virement bancaire SEPA, etc.).

### Liste des paiements

La page liste affiche tous les paiements synchronisés depuis Mollie avec :

- **ID Mollie** (`tr_xxxx`) - Lien cliquable vers la fiche détaillée
- **Montant** et **Devise**
- **Frais** prélevés par Mollie sur la transaction
- **Méthode** de paiement utilisée
- **Statut** du paiement
- **Date de création**

![Liste des paiements Mollie avec les colonnes ID, montant, méthode et statut](screenshots/paiements-liste.webp)

**Actions disponibles :**

- **Synchroniser** - Récupère les paiements récents depuis l'API Mollie
- **Nouveau** - Crée un nouveau paiement (si les droits le permettent)
- Filtrage par statut, méthode, date, montant

### Frais Mollie

Mollie ne communique pas les frais au moment du paiement : ils ne sont connus qu'une fois
la transaction portée sur votre balance Mollie, ce qui peut prendre de quelques minutes à
plusieurs jours selon la méthode de paiement. La colonne **Frais** reste donc à zéro tant
que Mollie n'a pas réglé la transaction.

Les frais sont récupérés depuis les transactions de balance Mollie :

- à chaque **Synchroniser** depuis la liste des paiements,
- à chaque **Actualiser depuis Mollie** depuis la fiche d'un paiement,
- automatiquement par la tâche planifiée **MollieCheckPay**, qui rattrape les paiements
  réglés depuis le passage précédent.

Deux limites à connaître :

- en **mode test**, l'API des balances ne renvoie rien : les frais restent toujours à zéro ;
- la clé API utilisée doit avoir accès aux balances, sinon les frais ne peuvent pas être lus
  (le détail est tracé dans les logs Dolibarr).

Si la constante `MOLLIE_ADD_FEES` vaut `PAYMENT` (ajout d'une ligne de débit pour chaque
frais lié à un encaissement), l'écriture de frais correspondante est ajoutée sur le compte
bancaire. Elle n'est créée que lorsque le montant des frais est réellement connu, jamais
avec un montant nul.

### Quand un paiement est refusé

Le module refuse de démarrer un paiement dans les cas suivants. Le client voit un message
à l'écran et la raison est tracée dans les logs Dolibarr.

| Situation | Raison |
|-----------|--------|
| Facture déjà soldée | Plus rien n'est dû, avoirs et acomptes compris |
| Facture brouillon, annulée ou abandonnée | Seule une facture validée peut recevoir un règlement |
| Commande déjà facturée | C'est la facture qui doit être payée |
| Commande non validée ou annulée | L'objet n'est pas prêt à être payé |
| Dolibarr non accessible en HTTPS | Mollie ne pourrait pas notifier le paiement |
| Montant nul | Il n'y a rien à encaisser |

Le montant encaissé est toujours calculé à partir de l'objet payé (reste à payer de la
facture, total de la commande, acompte configuré). Il n'est jamais lu dans la requête du
navigateur.

### Reprise d'un paiement abandonné

Si un client quitte la page de paiement Mollie sans aller au bout, il peut revenir payer
plus tard depuis le même lien :

- si la session de paiement Mollie est **encore ouverte**, le client est renvoyé vers cette
  même page de paiement ;
- si elle est **expirée, échouée ou annulée**, un nouveau paiement est créé et vient
  remplacer la tentative précédente ;
- si elle est **déjà payée** ou **en cours de traitement**, aucun second paiement n'est
  démarré et un message invite le client à vous contacter.

### Paiement en attente de confirmation

Certaines méthodes ne sont pas confirmées immédiatement : un virement bancaire reste en
attente tant que l'argent n'est pas arrivé, un paiement en plusieurs fois reste autorisé
jusqu'à sa capture.

Dans ces cas, le client voit une page **"Paiement en cours de confirmation"**, ni succès ni
échec, et aucun message d'erreur n'est envoyé. Le règlement est enregistré dans Dolibarr
dès que Mollie confirme le paiement, par webhook ou par la tâche planifiée.

### Factures en devise étrangère

Si le module multidevise est actif et que la facture est libellée dans une autre devise que
celle de votre société, le client est débité du **montant en devise de la facture**, dans
cette devise. Le règlement est enregistré dans Dolibarr avec le taux de change de la
facture.

Un paiement reçu dans une devise qui ne correspond pas à celle de l'objet, ou pour un
montant différent de celui annoncé au départ, est refusé et signalé dans les logs.

### Statuts des paiements

| Statut | Description |
|--------|-------------|
| Brouillon | Paiement créé, en attente d'action |
| Autorisé | Paiement autorisé par la banque, en attente de capture |
| Payé | Paiement reçu et confirmé |
| En cours | Capture envoyée, traitement en cours |
| Disputé | Le client a contesté le paiement |
| Expiré | Le paiement a expiré (délai dépassé) |
| Échoué | Le paiement a échoué |
| Refusé | Le paiement a été refusé par la banque |
| À capturer | En attente de capture par la banque |
| Annulé | Le paiement a été annulé |

### Fiche d'un paiement

La fiche détaillée d'un paiement affiche :

- Informations générales : montant, devise, méthode, description
- Dates : création, expiration, paiement
- Lien vers le tiers Dolibarr associé
- Lien vers la facture Dolibarr liée (si applicable)

![Fiche détaillée d'un paiement Mollie avec les informations générales et les actions disponibles](screenshots/paiement-fiche.webp)

**Actions disponibles sur la fiche :**

- **Actualiser depuis Mollie** - Met à jour les informations depuis l'API
- **Annuler** - Annule un paiement en attente (si l'API le permet)
- **Capturer** - Lance la capture d'un paiement autorisé
- **Libérer l'autorisation** - Libère une autorisation de paiement non capturée
- **Rembourser** - Rembourse tout ou partie du paiement
- **Supprimer** - Supprime l'enregistrement local (brouillon uniquement)

### Détails du virement bancaire

Lorsqu'un paiement utilise la méthode **virement bancaire** (`banktransfer`), la fiche affiche des informations supplémentaires :

- **Référence de virement** - Référence unique que le client doit indiquer lors du virement
- **IBAN du compte destinataire** - IBAN du compte Mollie sur lequel le client doit effectuer le virement
- **Code BIC** - Code BIC de la banque destinataire
- **Banque destinataire** - Nom de la banque

Le flux est le suivant :

1. Le client choisit "virement bancaire" lors du paiement
2. Mollie fournit un IBAN et une référence de virement unique
3. Le client effectue le virement depuis sa banque en indiquant la référence
4. Mollie rapproche automatiquement le virement grâce à la référence
5. Un webhook est envoyé et le statut passe à **Payé**

> Le délai par défaut pour recevoir le virement est de 12 jours ouvrés + 2 jours de traitement. Passé ce délai, le paiement expire automatiquement. Le paiement est mappé vers le mode de paiement Dolibarr **VIR** (virement).

### Onglets de la fiche paiement

- **Fiche** - Détails du paiement
- **Remboursements** - Liste des remboursements associés (voir [Remboursements](/mollie/remboursements))
- **Contestations** - Contestations liées à ce paiement (voir [Contestations](/mollie/remboursements))
- **Captures** - Captures effectuées (voir [Captures](/mollie/remboursements))

## Inscriptions à un événement et stands

Le module prend en charge le paiement en ligne des **inscriptions à un événement** et des
**réservations de stand** du module Dolibarr *Organisation d'événement*.

Le flux est celui du coeur de Dolibarr : depuis la page publique d'inscription, le
participant arrive sur la page de paiement, où le bouton Mollie apparaît au même titre que
pour une facture.

Une fois le paiement confirmé :

1. Le règlement est enregistré sur la **facture d'inscription**, sur le compte bancaire
   Mollie, comme n'importe quel autre paiement du module
2. Le **participant** passe au statut *Validé*, avec le montant payé et la date d'inscription
3. Pour un stand, la **réservation** passe au statut *Suggéré*
4. Le mail de confirmation du module Organisation d'événement est envoyé, s'il est configuré

> Rejouer la notification ou recharger la page de retour ne valide pas deux fois : le
> participant déjà validé et le stand déjà suggéré sont laissés en l'état.

## Cotisations d'adhérents

Le module prend en charge le paiement en ligne des **cotisations** du module Dolibarr
*Adhérents*. Depuis le lien de paiement d'un adhérent, celui-ci arrive sur la page de
paiement où le bouton Mollie apparaît, avec le choix du moyen de paiement (carte, iDEAL,
Bancontact, etc.) selon ce qui est activé sur votre compte Mollie.

### Montant de la cotisation

Une cotisation ne porte pas de montant comme le ferait une facture : il est déterminé
côté serveur, dans cet ordre :

1. le montant du **type d'adhérent**
2. à défaut, la constante **MEMBER_NEWFORM_AMOUNT**
3. à défaut, le montant de la **dernière cotisation** de l'adhérent

Si le type d'adhérent autorise l'adhérent à choisir son montant (*Montant modifiable*), le
montant saisi est accepté, à condition de respecter **MEMBER_MIN_AMOUNT**. Sinon, le
montant du type s'applique : une valeur différente envoyée par le navigateur est ignorée,
et un encaissement qui ne correspond pas au montant autorisé est refusé et journalisé.

Si **MEMBER_ALLOW_CHANGE_OF_TYPE** est activé, le type choisi sur la page de paiement est
appliqué : le montant et la cotisation enregistrée suivent ce type. Un type inconnu ou
désactivé n'est jamais retenu.

### Ce qui est enregistré après le paiement

1. L'adhérent encore en **brouillon** est validé
2. La **cotisation** est créée, sur la période qui suit celle en cours pour un
   renouvellement
3. Les écritures complémentaires suivent le paramétrage **ADHERENT_BANK_USE** du module
   Adhérents :
   * *Écriture bancaire directe* : ligne bancaire sur le **compte Mollie**
   * *Facture et écriture bancaire* : tiers créé si besoin, facture, règlement et ligne
     bancaire
   * *Facture seule* : facture, sans écriture bancaire
   * *Aucune* : la cotisation seule
4. Le **mail de confirmation d'adhésion** est envoyé s'il est configuré
   (ADHERENT_EMAIL_TEMPLATE_SUBSCRIPTION ou texte du type d'adhérent), et l'**utilisateur
   externe** est créé si ADHERENT_CREATE_EXTERNAL_USER_LOGIN est activé

> Le compte bancaire utilisé est celui du module Mollie. Le coeur de Dolibarr ne connaît
> ici que les comptes PayBox, PayPal et Stripe : sans ce traitement, l'encaissement
> échouerait sur "compte bancaire non paramétré".

> Rejouer la notification ou recharger la page de retour ne crée jamais deux cotisations
> pour le même paiement Mollie.

## Reversements (Payouts)

Accès : **Banque > Mollie > Reversements**

Les reversements représentent les virements que Mollie effectue vers votre compte bancaire. Mollie regroupe les paiements reçus et les reverse périodiquement (généralement quotidiennement ou hebdomadairement selon votre configuration Mollie).

### Liste des reversements

La page liste affiche :

- **ID Mollie** du reversement
- **Montant** viré
- **Date** du virement
- **Statut**

![Liste des reversements Mollie avec les montants virés et les dates](screenshots/reversements-liste.webp)

### Synchronisation

Les reversements sont automatiquement synchronisés via :

- Le bouton **Synchroniser** sur la page liste
- La tâche planifiée quotidienne **MollieCheckPay** (voir [Tâches planifiées](/mollie/webhooks))
- Les webhooks Mollie (notifications automatiques)