MBI Up2pay ETransactions

🎯 Présentation du module

MBI Up2pay ETransactions encaisse vos factures et vos commandes par carte bancaire, en ligne, via la solution de paiement Up2Pay E-Transactions du Crédit Agricole. Le module ajoute un mode de règlement « Carte Internet » à Dolibarr, génère un lien de paiement pour chaque document, l'envoie à votre client par courriel, puis enregistre automatiquement le règlement et solde la facture dès que la banque confirme la transaction. Il est conforme à la réglementation DSP2 et prend en charge 3-D Secure v2.

L'utilisation du module suppose un contrat Up2Pay E-Transactions auprès du Crédit Agricole, avec les identifiants de boutique fournis par la banque (numéro de site, rang, identifiant et clé secrète), un compte bancaire configuré dans Dolibarr et des pages de retour joignables depuis Internet.

🌐 Démo : https://demo.mbicloud.fr 🛒 Découvrez nos autres modules sur Dolistore.

💡 Avantages

• Vos clients règlent en ligne, immédiatement, sans que vous ayez à ressaisir quoi que ce soit.
• Le règlement, l'écriture bancaire et le passage de la facture au statut payé sont automatiques.
• Le lien de paiement part avec la facture ou avec la commande, dans un courriel que vous rédigez une fois pour toutes.
• Vous pouvez demander un acompte, ou proposer un paiement en deux ou trois fois, sans quitter Dolibarr.
• Votre client connaît l'échéancier complet avant de saisir sa carte : montant du jour, dates et montants à venir.
• Un mode test permet de valider toute la chaîne avant d'encaisser le premier euro.

⚙️ Fonctionnalités clés

💳 Encaissement par carte bancaire

• Mode de règlement « Carte Internet » : ajouté par le module et utilisable sur les factures comme sur les commandes client.
• Lien de paiement sécurisé : généré par document, avec une empreinte à usage unique.
• Paiement depuis une commande : le lien est créé à la validation de la commande et permet de régler cette commande, et non un autre document.
• Page de paiement au choix : une page aux couleurs de votre société, ou la page de paiement en ligne native de Dolibarr.

✉️ Courriels au client

• Envoi automatique du lien par courriel : au moment de l'envoi de la facture ou de la commande, avec un objet et un modèle de message personnalisables et une éventuelle copie à des adresses de votre choix.
• Image de confiance : affichée dans le courriel, reprenant le numéro de téléphone du client.
• Courriel de facture acquittée : envoyé après encaissement, avec le PDF en pièce jointe, objet et modèle personnalisables.

💶 Souplesse de règlement

• Acompte : un champ supplémentaire permet de n'encaisser qu'une partie du montant, plafonnée au solde restant dû.
• Paiement en deux ou trois fois : le montant est divisé en parts égales, chaque échéance étant prélevée un mois après la précédente.
• Échéancier annoncé avant la saisie de la carte : la page de paiement indique le montant réglé le jour même ainsi que la date et le montant de chaque prélèvement à venir.
• Carte contrôlée pour toute la durée de l'échéancier : une carte expirant avant la dernière échéance est refusée au moment de l'achat, tant que le client peut encore en présenter une autre.
• Création de la facture depuis la commande : lorsque le règlement porte sur une commande, la facture est créée automatiquement.

🔄 Traitement des retours de la banque

• Enregistrement automatique du règlement : au retour de la banque, création du paiement, écriture sur le compte bancaire configuré, passage de la facture au statut payé.
• Traitement fiable des notifications : une notification en double ne crée pas de second règlement, un montant supérieur au solde n'est jamais enregistré tel quel, et un incident en cours d'enregistrement est repris proprement plutôt que de laisser une écriture incomplète.

🛡️ Sécurité et architecture

• Multi-entité : les règlements réalisés sur une entité secondaire sont correctement rattachés.
• Montant recalculé au moment du règlement : la somme encaissée est déterminée par le module à partir du document, et non par la page affichée au client.
• Lien devenu sans objet automatiquement refusé : une facture soldée, abandonnée ou encore au brouillon, comme une commande déjà facturée, annulée ou encore au brouillon, n'est plus payable.
• Protection contre le double encaissement : tant qu'un échéancier est en cours auprès de la banque, la réouverture du lien est refusée ; le solde reste réglable en une fois une fois l'échéancier terminé.
• Vérification de signature : les retours de la banque sont contrôlés par clé 2048 bits.
• Mode test : permet de valider l'intégration sans mouvement réel.
• Permissions : trois permissions distinctes, consultation, création ou modification, suppression.

🆕 Nouveautés récentes (2.1.0 / 2.0.1 / 2.0)

• Le paiement depuis une commande fonctionne réellement : le lien est créé à la validation de la commande, pointe sur cette commande et part au client lors de l'envoi de la commande par courriel.
• La page de paiement annonce l'échéancier complet — montant du jour et date de chaque prélèvement à venir — avant que le client ne saisisse sa carte.
• Un lien devenu sans objet est refusé : facture soldée, abandonnée ou au brouillon, commande déjà facturée, annulée ou au brouillon. Un échéancier bancaire en cours bloque toute réouverture du lien.
• Le montant encaissé est désormais recalculé sur le serveur, et un avis de la banque supérieur au solde n'est plus enregistré tel quel.
• Le module est traduit en six langues complètes : anglais, français, allemand, espagnol, italien et portugais.
• Nouvelle page de paiement aux couleurs de votre société, proposée en option à la place de la page de paiement native de Dolibarr, et sécurité renforcée avec une vérification de signature en clé 2048 bits.

✅ Compatibilité

• Dolibarr : 12.0+ (testé jusqu'à Dolibarr 23)
• PHP : 7.2+
• Langues : anglais, français, allemand, espagnol, italien, portugais.
• Contrat bancaire : un contrat Up2Pay E-Transactions auprès du Crédit Agricole est obligatoire, avec les identifiants de boutique fournis par la banque.
• Extension PHP openssl : optionnelle, utilisée pour la vérification de signature des retours.
• Autres modules : aucun module Dolibarr complémentaire n'est requis, et aucune incompatibilité connue n'est déclarée.

Module version: auto
Editeur/Licence: MB Informatique / GPL-v3
Langage interface: Anglais, Français, Allemand, Espagnol, Italien, Portugais
Assistance: MB Informatique
Prérequis:

• Dolibarr min version: auto
• Dolibarr max version: auto

🔧 Installation

1. Télécharger l'archive ZIP du module sans la décompresser.
2. Dans Dolibarr, aller dans Accueil > Configuration > Modules/Applications.
3. Ouvrir l'onglet Déployer/Installer un module externe.
4. Envoyer l'archive ZIP du module.
5. Rechercher puis activer MBI Up2pay ETransactions.
6. Configurer les options du module depuis sa page d'administration : identifiants de boutique fournis par le Crédit Agricole (numéro de site, rang, identifiant et clé secrète), compte bancaire d'encaissement, objets et modèles des deux courriels.
7. Attribuer les permissions requises aux utilisateurs concernés.
8. Pour une installation manuelle, déposer le dossier mbietransactions dans /htdocs/custom/.

ℹ️ Remarques d'utilisation

• Un contrat Up2Pay E-Transactions auprès du Crédit Agricole est obligatoire, avec les identifiants de boutique fournis par la banque : numéro de site, rang, identifiant et clé secrète.
• Un compte bancaire doit être configuré dans Dolibarr : c'est sur lui que les règlements seront enregistrés.
• Les pages de retour du module doivent être joignables depuis Internet, la banque les appelant directement pour notifier le résultat des transactions.
• Le paiement en deux ou trois fois est une option de votre contrat Up2pay, et non un réglage du module : sans elle, la banque refuse le paiement.
• Il est recommandé d'activer le mode test, de régler une facture de bout en bout pour vérifier que le retour de la banque est bien traité, puis de désactiver le mode test une fois la chaîne complète validée.
• Sauvegarder la base de données et les fichiers Dolibarr avant toute mise à jour, puis installer la nouvelle archive par-dessus la version existante. Certaines versions demandent de désactiver puis réactiver le module pour prendre effet ; le ChangeLog l'indique explicitement en tête de la version concernée, ce qui est le cas de la version 2.1.0.
• La désactivation du module libère l'activation de la licence et retire les constantes, les permissions et les déclarations du module. Les données créées sont conservées : la table des empreintes de paiement et les champs supplémentaires ajoutés aux factures et aux commandes ne sont pas supprimés, afin de préserver l'historique des transactions.

🎓 Services

• Formation sur le module disponible au tarif de 80 € HT.
• Support et mises à jour inclus pendant la durée de votre licence.

📄 Licence et conditions d'utilisation

Le module est distribué sous licence GNU General Public License v3 ou ultérieure (GPL v3+), dont le texte complet figure dans le fichier COPYING livré avec le module.

Les Conditions Générales d'Utilisation complètes sont livrées avec le module et consultables depuis son onglet « À propos » dans Dolibarr. Nos Conditions Générales de Vente sont accessibles à l'adresse https://www.mb-informatique.fr/cgv.html.

👨 💻 Éditeur

MBI Up2pay ETransactions est un module custom Dolibarr développé par MB Informatique.

Il s'adresse aux entreprises titulaires d'un contrat Up2Pay E-Transactions du Crédit Agricole qui souhaitent encaisser leurs factures et leurs commandes par carte bancaire directement depuis Dolibarr, sans ressaisie et sans outil intermédiaire.

Éditeur : MB Informatique
Contact : info@mb-informatique.fr
Site web : https://www.mb-informatique.fr

🔧 Journal des changements

Version 2.1.0 (02/08/2026)

• ⚠️ Action requise : désactivez puis réactivez le module après la mise à jour, afin d'ajouter le champ « Lien de paiement » sur les commandes.
• Nouveauté : le lien de paiement du module fonctionne désormais sur les commandes. Il ouvrait jusqu'ici une facture sans rapport avec la commande, ou annonçait un lien expiré.
• Nouveauté : le lien de paiement d'une commande est généré à sa validation, et envoyé au client lors de l'envoi de la commande par courriel, comme pour les factures.
• Sécurité : le montant encaissé est désormais recalculé sur le serveur. Il provenait d'un champ du formulaire de paiement, qu'un client pouvait modifier pour régler moins que le montant dû.
• Sécurité : un solde partiellement réglé n'est plus redécoupé en deux ou trois fois. Un client rouvrant son lien de paiement pouvait déclencher un second échéancier par-dessus celui déjà programmé par la banque, et se voir prélever davantage que le montant dû. Passé le premier règlement, le solde est encaissé en une seule fois.
• Correction : la facture créée depuis une commande n'hérite plus du paiement en deux ou trois fois de celle-ci, dont l'échéancier appartient à la commande.
• Correction : les dates d'échéance ne débordent plus sur le mois suivant. Une échéance calculée depuis un 31 tombait trois jours trop tard ; elle tombe désormais au dernier jour du mois visé.
• Correction : en paiement en deux ou trois fois, une carte expirant avant la dernière échéance est désormais refusée au moment de l'achat, quand le client peut encore en présenter une autre. Elle était acceptée, et les échéances suivantes échouaient plusieurs semaines après la vente.
• Sécurité : une facture entièrement réglée, abandonnée ou encore au brouillon n'est plus payable depuis le lien du module. Le lien, créé à la validation, n'expirait jamais et continuait d'accepter des règlements sur une facture qui ne devait plus rien.
• Sécurité : le lien est refusé lorsqu'un paiement en plusieurs fois est déjà en cours. Les échéances restantes sont détenues par la banque, qui les prélève seule : rouvrir le lien faisait payer une deuxième fois une somme déjà engagée. Un règlement saisi à la main, lui, laisse le lien utilisable pour le solde.
• Amélioration : la page de paiement annonce l'échéancier complet — montant du jour et date de chaque prélèvement à venir — avant que le client ne saisisse sa carte. Elle n'affichait que la première échéance, sous un libellé « montant total du règlement ».
• Amélioration : la page de configuration rappelle que le paiement en deux ou trois fois est une option de votre contrat Up2pay, et non un réglage du module. Sans elle, la banque refuse le paiement et votre client ne lit qu'un « paiement refusé » sans cause.
• Correction : un montant trop petit pour être fractionné — moins de 2 € en deux fois, moins de 3 € en trois fois — est désormais encaissé en une seule fois. Le paiement était bloqué, avec un message annonçant à tort que le montant était inférieur à 1 € alors que seule l'échéance l'était.
• Sécurité : un avis de la banque portant un montant supérieur au solde de la facture n'est plus enregistré tel quel. Le solde est encaissé, l'excédent est signalé au journal : une facture ne peut pas devoir plus que son solde, et l'écrire fausserait le rapprochement bancaire.
• Amélioration : conformité au kit d'intégration officiel Up2pay e-Transactions — le nom du porteur est toujours renseigné, la deuxième ligne d'adresse est transmise, et la liste des données de retour comme la vérification de signature sont alignées sur l'exemple fourni par la banque.
• Amélioration : un montant inférieur au minimum d'un euro accepté par la banque est signalé clairement au client, au lieu d'aboutir sur une erreur de la page de paiement.
• Amélioration : l'avis de paiement de la banque est acquitté dès le règlement enregistré, avant la génération du PDF et l'envoi du courriel. Les alertes « Warning e-Transactions » dues au délai d'attente disparaissent.
• Correction : une commande déjà facturée, annulée ou encore au brouillon n'est plus payable depuis le lien du module.

Version 2.0.1 (30/07/2026)

• Sécurité : les pages de résultat de paiement ne chargent plus de feuille de style depuis Google, le navigateur de votre client n'est donc plus sollicité par un tiers pendant le règlement.
• Correction : la feuille de style de paiement en ligne configurée dans Dolibarr est désormais appliquée aux pages de résultat ; elle était construite puis abandonnée.
• Amélioration : la documentation du module s'affiche dans la langue de l'utilisateur sur l'onglet À propos, en anglais, français, allemand, italien et espagnol.

Version 2.0 (18/06/2026)

• ⚠️ Action requise : désactivez puis réactivez le module après la mise à jour pour prendre en compte les changements apportés par cette version.
• Nouveauté : page de paiement aux couleurs de votre société en option, ou redirection vers la page de paiement native de Dolibarr (comportement par défaut inchangé).
• Nouveauté : l'acompte et le paiement en deux ou trois fois sont désormais disponibles sur les commandes, et non plus seulement sur les factures.
• Sécurité : correction d'une faille sur la page de paiement publique et durcissement de la vérification de signature, désormais en clé 2048 bits.
• Amélioration : un double avis de la passerelle ne crée plus de second règlement, et un échec en cours d'enregistrement est repris proprement au lieu de laisser un règlement incomplet.
• Correction : les options d'acompte et de paiement en plusieurs fois étaient ignorées depuis la 1.6 et invisibles sur la fiche ; elles sont rétablies et modifiables.
• Correction : un montant comportant une fraction de centime pouvait être encaissé jusqu'à cent fois trop élevé.
• Correction : un acompte supérieur au solde dû ne peut plus encaisser davantage que ce qui reste à payer.
• Correction : les paiements réalisés sur une entité secondaire étaient perdus, ils sont désormais enregistrés.
• Compatibilité : prise en charge de PHP 8.5, version minimale de Dolibarr portée à 12.0.

Version 1.6.0 (08/08/2025)

• Nouveauté : le paiement peut être lancé depuis une commande client, la facture étant créée automatiquement.
• Amélioration : le lien de paiement peut être généré lors de la validation d'un règlement via l'API Dolibarr.
• Correction : anomalie mineure de validation du numéro de téléphone.

Version 1.5.0 (25/09/2024)

• Nouveauté : réglages du numéro de téléphone ajoutés à la configuration du module.

Version 1.4.0 (20/08/2024)

• Nouveauté : réglage déterminant à quel moment une facture est marquée comme payée.
• Compatibilité : prise en charge de la dernière version de Dolibarr et du multi-société.

Version 1.3.0 (15/11/2023)

• Correction : contrôle du mode de règlement face au cœur de Dolibarr.
• Amélioration : code nettoyé et optimisé.

Version 1.2.0 (06/10/2023)

• Sécurité : ajout de la clé publique et activation de la vérification de signature.
• Sécurité : renforcement général de la protection.
• Correction : diverses anomalies mineures.

Version 1.1.0 (26/07/2023)

• Nouveauté : les objets des courriels peuvent être définis depuis la configuration du module.
• Nouveauté : ajout des traductions anglaises.
• Amélioration : mise à jour du style d'affichage.
• Correction : diverses anomalies.

Version 1.0

• Version initiale.