SEPA-Lastschrift
SEPA-Lastschrift als Zahlungsart für Shopware 6.7: Mandatserfassung im Checkout, IBAN-Prüfung, verschlüsselte Speicherung, Mandats-PDF und Mandatsverwaltung im Admin. Kein Payment Provider, der Einzug erfolgt über deine Bank.
SEPA-Lastschrift
Diese Dokumentation bezieht sich immer auf die aktuellste veröffentlichte Version.
Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
Wichtiger Hinweis
Dieses Plugin ist KEIN Payment Provider. Es erfasst und verwaltet SEPA-Mandate, zieht aber keine Beträge ein.
Das Plugin leistet Folgendes nicht:
- Keine automatische Abbuchung: Es gibt keinen Export einer SEPA-Datei und keine Bankanbindung. Du reichst die Lastschriften selbst bei deiner Bank ein.
- Keine Risiko- oder Bonitätsprüfung: Es gibt weder Betrugserkennung noch Scoring.
- Keine Zahlungsgarantie: Rücklastschriften sind möglich. Das Plugin kennt sie nicht und ändert den Zahlungsstatus der Bestellung nicht.
Es eignet sich für Händler, die bereits einen eigenen Bankzugang für Lastschrifteinzüge haben und die Mandatsverwaltung in Shopware abbilden möchten.
Überblick
Das Plugin ergänzt Shopware um die Zahlungsart SEPA-Lastschrift. Kunden geben im Checkout IBAN, Kontoinhaber und ihre Zustimmung zum Mandat ein. Das Plugin prüft die Angaben, speichert die IBAN verschlüsselt, erzeugt eine Mandatsreferenz und stellt ein Mandats-PDF bereit. Du siehst alle Mandate im Admin und ziehst die Beträge außerhalb des Plugins über deine Bank ein.
graph TD
A["Checkout mit Zahlungsart SEPA-Lastschrift"] --> B{"Aktives Mandat vorhanden?"}
B -->|"Ja, wiederverwendet"| C["Bestellung mit bestehendem Mandat"]
B -->|"Nein oder neue Bankdaten"| D["IBAN, Kontoinhaber und Zustimmung prüfen"]
D --> E["Bestellung abschließen"]
E --> F["Neues Mandat speichern, IBAN verschlüsselt"]
F --> G["Event mmd.sepa_payment.mandate.created"]
C --> H["Mandats-PDF und Mandatsliste im Admin"]
G --> H
H --> I["Einzug über deine Bank, außerhalb des Plugins"]
Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Voraussetzungen, Installation, Zahlungsart zuweisen, Update, Deinstallation |
| Konfiguration | Gläubigerdaten, Mandatsreferenz, Mandatstexte, Mandate im Admin |
| Checkout und Kundenkonto | Ablauf im Checkout, Prüfregeln, Mandatsseite, PDF-Download |
| Entwickler-API | Event, Service-Interface, Admin- und Storefront-Routen |
| Datenschutz und Sicherheit | Gespeicherte Daten, Verschlüsselung, Löschung, Abgrenzung |
| Fehlerbehebung und FAQ | Typische Probleme, bekannte Einschränkungen, häufige Fragen |
| Technische Details | Ablauf im Payment-Handler, Komponenten, Datenbank |
Features
| Feature | Beschreibung |
|---|---|
| Zahlungsart SEPA-Lastschrift | Mandatserfassung mit IBAN, optionaler BIC und Kontoinhaber im Checkout |
| IBAN-Prüfung | Format, länderspezifische Länge und Prüfsumme (Modulo 97) für EU- und weitere SEPA-Länder |
| Verschlüsselte Speicherung | IBAN mit AES-256-GCM verschlüsselt, Schlüssel aus dem APP_SECRET abgeleitet |
| Mandatsreferenz | Automatisch erzeugt aus Präfix, Datum und Zufallsanteil |
| Wiederverwendung | Ein bestehendes aktives Mandat lässt sich bei weiteren Bestellungen verwenden |
| Mandats-PDF | Download für Kunden, Gäste und im Admin, in Deutsch oder Englisch |
| Kundenkonto | Mandat anlegen, ansehen und widerrufen |
| Mandatsverwaltung im Admin | Liste, Details, PDF und Widerruf |
| Mandatstext | Konfigurierbar in Deutsch und Englisch |
| Event | mmd.sepa_payment.mandate.created für eigene Integrationen |
Anforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| Shopware | ~6.7.0 |
|
| PHP | >=8.2 |
|
| dompdf | ^2.0.4 \|\| ^3.0 |
Wird als Abhängigkeit des Plugins installiert |
APP_SECRET |
nicht leer | Grundlage der IBAN-Verschlüsselung |
Lizenz
Kommerzielle Lizenz: Eine Lizenz gilt für eine Shopware-Installation einschließlich aller Sales Channels sowie der zugehörigen Entwicklungs- und Staging-Umgebungen. Weitergabe ist nicht erlaubt. Updates sind 12 Monate ab Kauf enthalten. Die vollständigen Bedingungen stehen in der Datei LICENSE des Plugins.
Support
Bei Fragen zur Lizenz, technischen Fragen oder Fehlern erreichst du mich unter support@markus-michalski.net.