Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net
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.
bcmod() aus der Erweiterung bcmath.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.