MBI Up2pay ETransactions

🎯 Modulübersicht

MBI Up2pay ETransactions zieht Ihre Rechnungen und Kundenaufträge online per Bankkarte ein, über die Zahlungslösung Up2Pay E-Transactions von Crédit Agricole. Das Modul ergänzt Dolibarr um die Zahlungsart „Internet-Karte“, erzeugt für jedes Dokument einen Zahlungslink und sendet ihn per E-Mail an Ihren Kunden. Anschließend verbucht es die Zahlung automatisch und setzt die Rechnung auf bezahlt, sobald die Bank die Transaktion bestätigt. Es entspricht der PSD2-Regulierung und unterstützt 3-D Secure v2.

Erforderlich sind ein Vertrag Up2Pay E-Transactions bei Crédit Agricole mit den von der Bank bereitgestellten Shop-Zugangsdaten sowie ein in Dolibarr konfiguriertes Bankkonto. Die Oberfläche des Moduls ist in sechs Sprachen verfügbar: Englisch, Französisch, Deutsch, Spanisch, Italienisch und Portugiesisch.

🌐 Demo: https://demo.mbicloud.fr 🛒 Entdecken Sie unsere weiteren Module auf Dolistore.

💡 Vorteile

• Ihre Kunden zahlen sofort online, ohne dass Sie irgendetwas erneut erfassen müssen.
• Die Zahlung, die Bankbuchung und der Wechsel der Rechnung in den Status „bezahlt“ erfolgen automatisch.
• Der Zahlungslink wird mit der Rechnung oder mit dem Auftrag versendet, in einer E-Mail, die Sie ein einziges Mal verfassen.
• Sie können eine Anzahlung anfordern oder eine Zahlung in zwei oder drei Raten anbieten, ohne Dolibarr zu verlassen.
• Ein Testmodus erlaubt es, die gesamte Kette zu prüfen, bevor der erste Euro eingezogen wird.

⚙️ Wichtigste Funktionen

💳 Zahlung und Einzug

• Zahlungsart „Internet-Karte“: eine zusätzliche Zahlungsart, nutzbar für Kundenrechnungen und Kundenaufträge.
• Gesicherter Zahlungslink: je Dokument wird ein Link auf Basis eines einmalig gültigen Hashwerts erzeugt.
• Anzahlung: Ein zusätzliches Feld erlaubt es, nur einen Teil des Betrags einzuziehen, begrenzt auf den offenen Restbetrag.
• Zahlung in zwei oder drei Raten: Der Betrag wird in gleiche Teile aufgeteilt, wobei jede Rate einen Monat nach der vorherigen eingezogen wird.
• Ankündigung des vollständigen Zahlungsplans: Der heute fällige Betrag und das Datum jeder künftigen Abbuchung werden dem Kunden angezeigt, bevor er seine Kartendaten eingibt.
• Prüfung der Kartengültigkeit: Eine Karte, die vor der letzten Rate abläuft, wird bereits beim Kauf abgelehnt, solange der Kunde noch eine andere vorlegen kann.

🧾 Zahlung ab dem Kundenauftrag

• Zahlung ab dem Auftrag: Der Zahlungslink des Auftrags wird bei dessen Validierung erzeugt und verweist auf genau diesen Auftrag.
• Versand mit dem Auftrag: Der Link wird beim Versand des Auftrags per E-Mail an den Kunden übermittelt, genau wie bei einer Rechnung.
• Erstellung der Rechnung aus dem Auftrag: wenn sich die Zahlung auf einen Kundenauftrag bezieht.

✉️ Kommunikation mit dem Kunden

• Automatischer Versand des Links per E-Mail: beim Versenden der Rechnung oder des Auftrags, mit anpassbarem Betreff und anpassbarer Nachrichtenvorlage sowie einer möglichen Kopie an Adressen Ihrer Wahl.
• Vertrauensbild: wird in der E-Mail angezeigt und greift die Telefonnummer des Kunden auf.
• Wahl der Zahlungsseite: eine Seite in den Farben Ihres Unternehmens oder die native Online-Zahlungsseite von Dolibarr.
• E-Mail zur bezahlten Rechnung: nach dem Einzug versendet, mit dem PDF im Anhang sowie anpassbarem Betreff und anpassbarer Vorlage.

🔄 Automatisierung in Dolibarr

• Automatische Verbuchung der Zahlung: bei der Rückmeldung der Bank werden die Zahlung angelegt, auf dem konfigurierten Bankkonto verbucht und die Rechnung in den Status „bezahlt“ versetzt.
• Zuverlässige Verarbeitung der Benachrichtigungen der Bank: Eine doppelte Benachrichtigung erzeugt keine zweite Zahlung, und eine Störung während der Verbuchung wird sauber wiederaufgenommen, statt eine unvollständige Buchung zu hinterlassen.
• Mehrsprachige Oberfläche: Modul und Zahlungsseiten liegen in sechs vollständigen Übersetzungen vor — Englisch, Französisch, Deutsch, Spanisch, Italienisch und Portugiesisch.

🛡️ Sicherheit und Architektur

• Verfall gegenstandslos gewordener Links: Eine vollständig beglichene, abgebrochene oder noch im Entwurf befindliche Rechnung sowie ein bereits in Rechnung gestellter, stornierter oder noch im Entwurf befindlicher Auftrag lassen sich über den Link nicht mehr bezahlen.
• Schutz vor doppeltem Einzug: Solange ein Ratenplan bei der Bank läuft, wird der Zahlungslink abgewiesen, damit ein bereits eingeplanter Betrag nicht ein zweites Mal belastet wird.
• Einzug des tatsächlich geschuldeten Betrags: Der eingezogene Betrag wird stets auf dem Server aus dem Beleg selbst ermittelt und lässt sich über die Zahlungsseite nicht verändern.
• Mandantenfähigkeit: Zahlungen, die auf einer sekundären Entität erfolgen, werden korrekt zugeordnet.
• Signaturprüfung: die Rückmeldungen der Bank werden mit einem 2048-Bit-Schlüssel geprüft.
• Testmodus: zur Validierung der Integration ohne echte Bewegung.
• Berechtigungen: drei getrennte Rechte — Lesen, Anlegen oder Ändern, Löschen.
• Integration ohne Überschreibung: Das Modul ist darauf ausgelegt, sich in die Standardoberfläche von Dolibarr einzufügen, ohne den Kern zu überschreiben.

🆕 Neuerungen der letzten Versionen (2.1.0 / 2.0.1 / 2.0)

• Die Zahlung ab einem Kundenauftrag funktioniert nun vollständig: Der Link wird bei der Validierung des Auftrags erzeugt, verweist auf diesen Auftrag und wird beim Versand des Auftrags per E-Mail an den Kunden übermittelt.
• Die Zahlungsseite kündigt den gesamten Ratenplan an — den heute fälligen Betrag und das Datum jeder künftigen Abbuchung —, bevor der Kunde seine Kartendaten eingibt.
• Sicherheit: Ein gegenstandslos gewordener Link wird abgewiesen (beglichene, abgebrochene oder im Entwurf befindliche Rechnung; bereits fakturierter, stornierter oder im Entwurf befindlicher Auftrag), ein laufender Ratenplan bei der Bank verhindert jedes erneute Öffnen, und der eingezogene Betrag wird auf dem Server neu berechnet.
• Das Modul liegt nun in sechs vollständigen Übersetzungen vor: Englisch, Französisch, Deutsch, Spanisch, Italienisch und Portugiesisch.
• Optionale Zahlungsseite in den Farben Ihres Unternehmens oder Weiterleitung auf die native Online-Zahlungsseite von Dolibarr; Anzahlung und Ratenzahlung stehen auch für Kundenaufträge zur Verfügung.
• Zuverlässigkeit und Sicherheit: Schwachstelle auf der öffentlichen Zahlungsseite behoben, Signaturprüfung mit 2048-Bit-Schlüssel, keine Ladevorgänge mehr von einem Stylesheet bei Google, saubere Verarbeitung doppelter Benachrichtigungen sowie Korrekturen bei Ratenfälligkeiten, Kartenablauf und Kleinstbeträgen.

✅ Kompatibilität

• Dolibarr: 12.0+ (getestet bis Dolibarr 23)
• PHP: 7.2+
• Sprachen der Oberfläche: Englisch, Französisch, Deutsch, Spanisch, Italienisch, Portugiesisch
• Up2Pay E-Transactions (Crédit Agricole): ein Vertrag bei Crédit Agricole mit den von der Bank bereitgestellten Shop-Zugangsdaten ist erforderlich (Site-Nummer, Rang, Kennung und geheimer Schlüssel).
• Bankkonto: ein in Dolibarr konfiguriertes Bankkonto, auf dem die Zahlungen verbucht werden, ist erforderlich.
• Erreichbarkeit aus dem Internet: Die Rückmeldeseiten des Moduls müssen aus dem Internet erreichbar sein, da die Bank sie direkt aufruft.
• openssl (optional): Die PHP-Erweiterung wird für die Signaturprüfung der Rückmeldungen verwendet.
• Es ist kein weiteres Dolibarr-Modul erforderlich, und es ist keine Inkompatibilität bekannt.

Module version: auto
Publisher/Licence: MB Informatique / GPL-v3
User interface language: English, French, German, Spanish, Italian, Portuguese
Help/Support: MB Informatique
Prerequisites:

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

🔧 Installation

1. Das ZIP-Archiv des Moduls herunterladen, ohne es zu entpacken.
2. In Dolibarr Startseite > Einstellungen > Module/Anwendungen aufrufen.
3. Den Reiter Externes Modul bereitstellen/installieren öffnen.
4. Das ZIP-Archiv des Moduls hochladen.
5. MBI Up2pay ETransactions suchen und anschließend aktivieren.
6. Die Optionen des Moduls über seine Administrationsseite konfigurieren: die von Crédit Agricole bereitgestellten Shop-Zugangsdaten eingeben und das Bankkonto auswählen, auf dem die Zahlungen verbucht werden.
7. Den betroffenen Benutzern die erforderlichen Berechtigungen zuweisen.
8. Für eine manuelle Installation den Ordner mbietransactions in /htdocs/custom/ ablegen.

ℹ️ Hinweise zur Nutzung

• Ein Vertrag Up2Pay E-Transactions bei Crédit Agricole ist zwingend erforderlich: Ohne die Shop-Zugangsdaten der Bank kann keine Zahlung eingezogen werden.
• Die Rückmeldeseiten des Moduls müssen aus dem Internet erreichbar sein, da die Bank sie direkt aufruft, um das Ergebnis der Transaktionen zu melden.
• Die Oberfläche des Moduls ist in sechs Sprachen verfügbar: Englisch, Französisch, Deutsch, Spanisch, Italienisch und Portugiesisch.
• Die Zahlung in zwei oder drei Raten ist eine Option Ihres Up2pay-Vertrags und keine Einstellung des Moduls: Ohne diese Option lehnt die Bank die Zahlung ab.
• Vor der Inbetriebnahme den Testmodus aktivieren und eine Rechnung vollständig bezahlen, um zu prüfen, dass die Rückmeldung der Bank korrekt verarbeitet wird; den Testmodus anschließend deaktivieren.
• Betreff und Vorlage der beiden E-Mails anpassen: der E-Mail mit dem Zahlungslink und der E-Mail zur bezahlten Rechnung.
• Vor jeder Aktualisierung die Datenbank und die Dolibarr-Dateien sichern und das ChangeLog lesen.
• Bei bestimmten Versionen muss das Modul deaktiviert und wieder aktiviert werden, damit die Änderungen wirksam werden; das ChangeLog weist zu Beginn der betreffenden Version ausdrücklich darauf hin. Dies gilt insbesondere für die Version 2.1.0, damit das Feld „Zahlungslink“ bei Aufträgen ergänzt wird.
• Die Deaktivierung des Moduls gibt die Lizenzaktivierung frei und entfernt die Konstanten, die Berechtigungen und die Deklarationen des Moduls.
• Die vom Modul erzeugten Daten bleiben erhalten: Die Tabelle der Zahlungs-Hashwerte sowie die den Rechnungen und Aufträgen hinzugefügten Zusatzfelder werden nicht gelöscht, um die Transaktionshistorie zu bewahren.

🎓 Leistungen

• Eine Schulung zum Modul wird zum Preis von 80 € zzgl. MwSt. angeboten.
• Support und Aktualisierungen sind für die Laufzeit Ihrer Lizenz inbegriffen.

📄 Lizenz und Nutzungsbedingungen

Das Modul wird unter der GNU General Public License v3 oder höher (GPL v3+) vertrieben; der vollständige Text liegt der Lieferung als Datei COPYING bei.

Die vollständigen Nutzungsbedingungen werden mit dem Modul ausgeliefert und sind in Dolibarr über dessen Registerkarte „Über“ einsehbar. Unsere Allgemeinen Geschäftsbedingungen finden Sie unter https://www.mb-informatique.fr/cgv.html.

👨 💻 Herausgeber

MBI Up2pay ETransactions ist ein Dolibarr-Custom-Modul, entwickelt von MB Informatique.

Es richtet sich an Unternehmen mit einem Vertrag Up2Pay E-Transactions von Crédit Agricole, die ihre Rechnungen und Kundenaufträge direkt aus Dolibarr heraus per Bankkarte einziehen möchten, ohne erneute Erfassung und ohne Zwischenwerkzeug.

Herausgeber: MB Informatique
Kontakt: info@mb-informatique.fr
Website: https://www.mb-informatique.fr

🛠 CHANGELOG

UPDATE 2.1.0 (2026-08-02)

• ⚠️ Aktion erforderlich: Das Modul nach der Aktualisierung deaktivieren und wieder aktivieren, damit das Feld „Zahlungslink“ bei Aufträgen ergänzt wird.
• Neuerung: Der Zahlungslink des Moduls funktioniert nun bei Aufträgen. Bisher öffnete er eine Rechnung ohne Bezug zum Auftrag oder meldete einen abgelaufenen Link.
• Neuerung: Der Zahlungslink eines Auftrags wird bei dessen Validierung erzeugt und dem Kunden beim Versand des Auftrags per E-Mail zugestellt, genau wie bei Rechnungen.
• Sicherheit: Der eingezogene Betrag wird nun auf dem Server neu berechnet. Er stammte aus einem Feld des Zahlungsformulars, das ein Kunde ändern konnte, um weniger als den fälligen Betrag zu zahlen.
• Sicherheit: Ein teilweise beglichener Restbetrag wird nicht mehr erneut aufgeteilt. Ein Kunde, der seinen Zahlungslink erneut öffnete, konnte einen zweiten Ratenplan über den bereits von der Bank gehaltenen legen und mehr als den fälligen Betrag belastet bekommen. Nach der ersten Zahlung wird der Restbetrag in einem Zug eingezogen.
• Korrektur: Eine aus einem Auftrag erstellte Rechnung übernimmt nicht mehr dessen Aufteilung in zwei oder drei Raten, deren Ratenplan zum Auftrag gehört.
• Korrektur: Die Ratenfälligkeiten laufen nicht mehr in den Folgemonat über. Ein von einem 31. aus berechnetes Datum fiel drei Tage zu spät; es fällt nun auf den letzten Tag des Zielmonats.
• Korrektur: Bei einer Zahlung in zwei oder drei Raten wird eine Karte, die vor der letzten Rate abläuft, nun beim Kauf abgelehnt, solange der Kunde noch eine andere vorlegen kann. Bisher wurde sie akzeptiert, und die späteren Raten scheiterten Wochen nach dem Verkauf.
• Sicherheit: Eine vollständig beglichene, abgeschriebene oder noch im Entwurf befindliche Rechnung kann über den Modullink nicht mehr bezahlt werden. Der bei der Validierung erzeugte Link lief nie ab und nahm weiterhin Zahlungen für eine Rechnung an, die nichts mehr schuldete.
• Sicherheit: Der Link wird abgelehnt, solange ein Ratenplan läuft. Die verbleibenden Raten hält die Bank, die sie selbstständig einzieht: Ein erneutes Öffnen des Links belastete den Kunden ein zweites Mal für bereits gebundenes Geld. Eine von Hand erfasste Zahlung lässt den Link für den Restbetrag weiterhin nutzbar.
• Verbesserung: Die Zahlungsseite kündigt nun den gesamten Ratenplan an — den heute fälligen Betrag und das Datum jeder künftigen Abbuchung — bevor der Kunde seine Karte eingibt. Bisher zeigte sie nur die erste Rate unter der Bezeichnung „Gesamtbetrag der Zahlung“.
• Verbesserung: Die Einrichtungsseite weist darauf hin, dass die Zahlung in zwei oder drei Raten eine Option Ihres Up2pay-Vertrags ist und keine Einstellung des Moduls. Ohne sie lehnt die Bank die Zahlung ab, und Ihr Kunde liest nur „Zahlung abgelehnt“, ohne Angabe eines Grundes.
• Korrektur: Ein Betrag, der für eine Aufteilung zu klein ist — unter 2 EUR bei zwei Raten, unter 3 EUR bei drei —, wird nun in einem Zug eingezogen. Die Zahlung war bisher blockiert, mit einer Meldung, die fälschlich behauptete, der Betrag liege unter 1 EUR, obwohl dies nur für die Rate galt.
• Sicherheit: Eine Benachrichtigung der Bank mit einem Betrag über dem Rechnungssaldo wird nicht mehr unverändert erfasst. Der Saldo wird eingezogen und der Überschuss im Protokoll gemeldet: Eine Rechnung kann nicht mehr als ihren Saldo schulden, und eine Buchung darüber hinaus würde den Bankabgleich verfälschen.
• Verbesserung: Konformität mit dem offiziellen Integrationskit Up2pay e-Transactions — der Name des Karteninhabers wird stets ausgefüllt, die zweite Adresszeile wird übermittelt, und sowohl die Liste der Rückgabedaten als auch die Signaturprüfung entsprechen dem von der Bank bereitgestellten Beispiel.
• Verbesserung: Ein Betrag unter dem von der Bank akzeptierten Mindestbetrag von einem Euro wird dem Kunden nun klar gemeldet, statt auf einem Fehler der Zahlungsseite zu enden.
• Verbesserung: Die Benachrichtigung der Bank wird bestätigt, sobald die Zahlung erfasst ist, also vor der Erzeugung des PDF und dem Versand der E-Mail. Die durch die Wartezeit verursachten Warnungen „Warning e-Transactions“ verschwinden.
• Korrektur: Ein bereits fakturierter, stornierter oder noch im Entwurf befindlicher Auftrag kann über den Modullink nicht mehr bezahlt werden.

UPDATE 2.0.1 (2026-07-30)

• Sicherheit: Die Seiten mit dem Zahlungsergebnis laden kein Stylesheet mehr von Google, sodass der Browser Ihres Kunden während der Zahlung von keinem Dritten kontaktiert wird.
• Korrektur: Das in Dolibarr konfigurierte Stylesheet für die Online-Zahlung wird nun auf den Seiten mit dem Zahlungsergebnis angewendet; es wurde bisher erzeugt und anschließend verworfen.
• Verbesserung: Die Dokumentation des Moduls wird im Reiter „Über“ in der Sprache des Benutzers angezeigt, auf Englisch, Französisch, Deutsch, Italienisch und Spanisch.

UPDATE 2.0 (2026-06-18)

• ⚠️ Aktion erforderlich: Das Modul nach der Aktualisierung deaktivieren und wieder aktivieren, damit die mit dieser Version eingeführten Änderungen wirksam werden.
• Neuerung: optionale Zahlungsseite in den Farben Ihres Unternehmens oder Weiterleitung auf die native Online-Zahlungsseite von Dolibarr (Standardverhalten unverändert).
• Neuerung: Anzahlung sowie Zahlung in zwei oder drei Raten stehen nun auch für Aufträge zur Verfügung, nicht mehr nur für Rechnungen.
• Sicherheit: Eine Schwachstelle auf der öffentlichen Zahlungsseite wurde behoben und die Signaturprüfung verstärkt; sie verwendet nun einen 2048-Bit-Schlüssel.
• Verbesserung: Eine doppelte Benachrichtigung des Zahlungsdienstes erzeugt keine zweite Verbuchung mehr, und eine Störung während der Verbuchung wird sauber wiederaufgenommen, statt eine unvollständige Buchung zu hinterlassen.
• Korrektur: Die Optionen Anzahlung und Ratenzahlung wurden seit 1.6 ignoriert und waren im Datensatz nicht bearbeitbar; beide sind wiederhergestellt.
• Korrektur: Ein Betrag mit einem Bruchteil eines Cents konnte bis zu hundertmal zu hoch eingezogen werden.
• Korrektur: Mit einer Anzahlung, die höher ist als der offene Restbetrag, kann nicht länger mehr eingezogen werden, als tatsächlich geschuldet ist.
• Korrektur: Zahlungen, die auf einer sekundären Entität erfolgten, gingen verloren und werden nun verbucht.
• Kompatibilität: Unterstützung von PHP 8.5, Mindestversion von Dolibarr auf 12.0 angehoben.

UPDATE 1.6.0 (2025-08-08)

• Neuerung: Die Zahlung kann aus einem Kundenauftrag gestartet werden, wobei die Rechnung automatisch erzeugt wird.
• Verbesserung: Der Zahlungslink kann erzeugt werden, wenn eine Zahlung über die Dolibarr-API validiert wird.
• Korrektur: kleineres Problem bei der Prüfung der Telefonnummer.

UPDATE 1.5.0 (2024-09-25)

• Neuerung: Einstellungen zur Telefonnummer in der Konfiguration des Moduls ergänzt.

UPDATE 1.4.0 (2024-08-20)

• Neuerung: Einstellung, mit der gesteuert wird, wann eine Rechnung als bezahlt gekennzeichnet wird.
• Kompatibilität: Unterstützung der neuesten Dolibarr-Version und der Mandantenfähigkeit.

UPDATE 1.3.0 (2023-11-15)

• Korrektur: Prüfung der Zahlungsart gegenüber dem Dolibarr-Kern.
• Verbesserung: Code bereinigt und optimiert.

UPDATE 1.2.0 (2023-10-06)

• Sicherheit: Öffentlicher Schlüssel ergänzt und Signaturprüfung aktiviert.
• Sicherheit: Gesamtschutz verstärkt.
• Korrektur: verschiedene kleinere Probleme.

UPDATE 1.1.0 (2023-07-26)

• Neuerung: Die Betreffzeilen der E-Mails können in der Konfiguration des Moduls festgelegt werden.
• Neuerung: englische Übersetzungen ergänzt.
• Verbesserung: Anzeigestil aktualisiert.
• Korrektur: verschiedene Probleme.

UPDATE 1.0

• Erste Version.