English Version

Zurück zur Übersicht

SEPA-Lastschrift: Fehlerbehebung und FAQ

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Fehlerbehebung

Symptom: Die Zahlungsart SEPA-Lastschrift erscheint im Checkout nicht.

Prüfen: Ist das Plugin aktiv und die Zahlungsart in den Einstellungen des Sales Channels zugewiesen? Das Plugin weist sie nicht selbst zu. Greifen Verfügbarkeitsregeln der Zahlungsart, die den Kunden ausschließen?

Lösung: Zahlungsart dem Sales Channel zuweisen, siehe Installation.

Symptom: Die Zahlung schlägt nach dem Absenden fehl, obwohl der Kunde alle Felder ausgefüllt hat.

Prüfen: Enthält der Kontoinhaber Umlaute, ß oder andere Zeichen außerhalb der erlaubten Menge (A-Z, a-z, Ziffern, Leerzeichen, / - ? : ( ) . , ' +)? Diese Prüfung läuft erst, wenn die Bestellung schon angelegt ist.

Lösung: Der Kunde soll den Namen ohne Sonderzeichen eingeben, zum Beispiel "Mueller" statt "Müller". Die Bestellung ist in diesem Fall bereits angelegt und muss von dir nachverfolgt werden.

Symptom: Fehlermeldung "Die SEPA-Zahlungsdaten sind unvollständig. Bitte prüfen Sie IBAN, Kontoinhaber und Mandatsbestätigung."

Prüfen: Sind IBAN und Kontoinhaber ausgefüllt, ist die Mandatszustimmung angehakt und ist die IBAN gültig? Diese Meldung gilt für alle Fehler in der Vorprüfung.

Lösung: Angaben korrigieren. Bei einer richtigen IBAN prüfen, ob der Ländercode zu den unterstützten Ländern gehört (siehe nächster Punkt).

Symptom: Eine gültige IBAN wird abgelehnt.

Prüfen: Steht ihr Ländercode in der Liste der unterstützten Länder (27 EU-Staaten, Island, Liechtenstein, Norwegen, Schweiz, Monaco, San Marino, Vatikanstadt, Vereinigtes Königreich)? Länder wie Andorra fehlen.

Lösung: Für IBANs außerhalb dieser Liste gibt es keine Einstellung. Die Zahlungsart lässt sich dafür nicht verwenden.

Symptom: Das Mandats-PDF lässt sich nicht erzeugen, Meldung "dompdf library not installed".

Prüfen: Wurde die Abhängigkeit dompdf/dompdf installiert, etwa per composer install im Shop-Projekt?

Lösung: composer require dompdf/dompdf ausführen oder das Plugin per Composer installieren, siehe Installation.

Symptom: Im PDF fehlen Name oder IBAN des Gläubigers.

Prüfen: Sind die Einstellungen unter "Allgemeine Einstellungen" gefüllt, und zwar für den Sales Channel, aus dem das PDF erzeugt wird? Das PDF aus dem Admin verwendet die allgemeinen Einstellungen.

Lösung: Gläubigerdaten in der Plugin-Konfiguration eintragen, siehe Konfiguration.

Symptom: Checkout, Kundenkonto-Seite oder PDF-Download brechen nach einem Serverwechsel oder einer Änderung des APP_SECRET mit einem Fehler ab.

Prüfen: Hat sich der APP_SECRET geändert? Die IBAN der Mandate ist mit einem daraus abgeleiteten Schlüssel verschlüsselt.

Lösung: Den ursprünglichen APP_SECRET wiederherstellen. Ist er verloren, lassen sich die IBANs nicht mehr entschlüsseln. Widerrufe dann die betroffenen Mandate im Admin (Bestellungen > SEPA-Mandate, Detailseite). Die Kunden geben bei der nächsten Bestellung neue Bankdaten ein. Beim Widerruf wird die IBAN nicht entschlüsselt.

Symptom: Die IBAN-Prüfung im Browser meldet "zu viele Anfragen" (HTTP 429).

Prüfen: Wurde die Route validate-iban mehr als 10 Mal in einer Minute von derselben IP aufgerufen?

Lösung: Eine Minute warten. Das Limit ist fest eingebaut.

Symptom: Ein Entwickler erhält das Event mmd.sepa_payment.mandate.created nicht.

Prüfen: Abonnierst du den Event-Namen als String? Wurde das Mandat auf der Kundenkonto-Seite angelegt, oder hat der Kunde ein bestehendes Mandat im Checkout wiederverwendet? In beiden Fällen wird das Event nicht ausgelöst, siehe Entwickler-API.

Bekannte Einschränkungen

• Pro Kunde gibt es höchstens ein aktives Mandat. Ein neues Mandat im Checkout widerruft das bisherige.
• Die Option "Mandats-Wiederverwendung erlauben" hat keine Wirkung.
• Der Status "Abgelaufen" wird nie automatisch gesetzt.
• Die Mandatsseite im Kundenkonto zeigt immer den mitgelieferten Standardtext statt des konfigurierten Mandatstexts.
• Das Mandat ist dem Kunden zugeordnet, nicht der Bestellung. Es gibt keine Mandatsangabe an der Bestellung im Admin.
• Im Admin sind keine Mandate anlegbar oder bearbeitbar, und die IBAN wird dort nicht angezeigt.
• Das Plugin zieht keine Beträge ein und erzeugt keine SEPA-Datei, siehe Datenschutz und Sicherheit.
• Die serverseitige IBAN-Prüfung nutzt die PHP-Funktion bcmod() aus der Erweiterung bcmath.

FAQ

Welche Zahlungsarten ersetzt das Plugin?

Keine. Es ergänzt die Zahlungsart SEPA-Lastschrift mit Mandatserfassung. Das Einziehen übernimmst du über deine Bank.

Wo finde ich die Mandatsdaten für den Einzug?

Im Admin unter Bestellungen > SEPA-Mandate (Referenz, Kontoinhaber, BIC, Zeitpunkt) und im Mandats-PDF, das die vollständige IBAN enthält.

Können Gäste per Lastschrift bezahlen?

Ja. Gäste laden ihr Mandats-PDF über den Link auf der Bestellabschlussseite herunter.

Wie lange werden Mandate gespeichert?

Bis du den Kunden löschst oder das Plugin ohne Datenerhalt deinstallierst. Das Plugin löscht nichts automatisch.