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

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.

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

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)

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)
• Contestations - Contestations liées à ce paiement (voir Contestations)
• Captures - Captures effectuées (voir Captures)

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

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)
• Les webhooks Mollie (notifications automatiques)