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 auf Englisch und Französisch verfügbar.

🌐 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 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.

✉️ Kommunikation mit dem Kunden

• Automatischer Versand des Links per E-Mail: beim Versenden der Rechnung, 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.
• Erstellung der Rechnung aus dem Auftrag: wenn sich die Zahlung auf einen Kundenauftrag bezieht.
• 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.

🛡️ Sicherheit und Architektur

• 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.0.1 / 2.0 / 1.6.0)

• Optionale Zahlungsseite in den Farben Ihres Unternehmens oder Weiterleitung auf die native Online-Zahlungsseite von Dolibarr.
• Anzahlung sowie Zahlung in zwei oder drei Raten stehen nun auch für Kundenaufträge zur Verfügung, nicht mehr nur für Rechnungen.
• Sicherheit: Schwachstelle auf der öffentlichen Zahlungsseite behoben, Signaturprüfung mit 2048-Bit-Schlüssel, und die Seiten mit dem Zahlungsergebnis laden kein Stylesheet mehr von Google.
• Zuverlässigkeit: doppelte Benachrichtigungen, Beträge mit einem Bruchteil eines Cents, zu hohe Anzahlungen und Zahlungen auf einer sekundären Entität wurden korrigiert.
• Die Zahlung kann aus einem Kundenauftrag gestartet werden, wobei die Rechnung automatisch erzeugt wird; Unterstützung von PHP 8.5 und Mindestversion Dolibarr auf 12.0 angehoben.

✅ Kompatibilität

• Dolibarr: 12.0+ (getestet bis Dolibarr 23)
• PHP: 7.2+
• Sprachen der Oberfläche: Englisch, Französisch
• 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
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 auf Englisch und Französisch verfügbar.
• 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.
• 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.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.