Plugin-Dokumentation · JTL-Shop 5
QR-Code Überweisung (Girocode) — Konfiguration & Bedienung
Alle Einstellungen im Detail sowie Hinweise zum Selbstcheck und zu den Grenzen des Plugins.
Einstellungen
Zu finden unter Plugins → QR-Code Überweisung → Einstellungen:
| Einstellung | Standard | Wirkung |
|---|---|---|
| Plugin aktivieren | Aktiviert | Globaler Schalter für QR-Box im Frontend und Mail-Block. |
| Empfängername (Kontoinhaber) | leer | Name des Zahlungsempfängers, wie er im Banking erscheint. Maximal 70 Zeichen. |
| IBAN | leer | IBAN des Händlerkontos. Leerzeichen sind erlaubt und werden automatisch entfernt. Die Prüfsumme wird validiert (siehe Selbstcheck). |
| BIC (optional) | leer | Für SEPA-Überweisungen im EWR nicht erforderlich. Ungültige BIC wird ignoriert. |
| Verwendungszweck-Muster | Bestellung {bestellnr} | Platzhalter {bestellnr} wird durch die Bestellnummer ersetzt. Wird auf 140 Zeichen gekürzt. |
| Zahlungsarten (Namensliste) | Vorkasse, Überweisung | Kommagetrennte Liste. Teilstring-Vergleich (Groß-/Kleinschreibung egal) gegen den Zahlungsart-Namen der Bestellung. Achtung: „Überweisung“ matcht auch „Sofortüberweisung“ — möglichst eindeutige Fragmente verwenden. |
| Zahlungsdaten in Bestellbestätigung | Aktiviert | Hängt die Zahlungsdaten als Text plus Link zur Statusseite (mit QR-Code) an die Bestellbestätigungs-Mail an. |
| Überschrift der QR-Box | Bequem per Banking-App bezahlen | Frontend-Überschrift der QR-Box. |
| Ziel-Selektor (Experten-Option) | leer (= automatische Erkennung) | CSS-Selektor, in den die QR-Box eingehängt wird (für Templates, die von NOVA abweichen). |
Wo erscheint die QR-Box?
Auf der Bestellabschluss-Seite (Danke-Seite) sowie auf der Bestellstatus-Seite (Link aus der Bestellbestätigung), solange die Bestellung unbezahlt ist. Auf der Bestellstatus-Seite erscheint die Box zusätzlich nur, wenn der Besucher den vom JTL-Kern verlangten zweiten Faktor erbracht hat (PLZ-Bestätigung oder Login) — ohne diesen Nachweis zeigt der Kern selbst nur Datum/Bestellnummer/Status, und das Plugin zeigt konsequent ebenfalls keine Zahlungsdaten.
Admin-Selbstcheck
Unter Plugins → QR-Code Überweisung → Selbstcheck prüft das Plugin IBAN- Prüfsumme, Empfängername, BIC, Verwendungszweck-Muster und Zahlungsarten-Liste und zeigt eine Beispiel-Payload-Vorschau mit Dummy-Bestellnummer. Eine ungültige Konfiguration führt nie zu einem Fehler im Shop, sondern lediglich zu „kein QR“ plus Meldung im Selbstcheck.
Mail-Fallback
Der Mail-Block nutzt den Shop-Hook HOOK_MAILER_PRE_SEND (JTL-Shop ≥ 5.1.2). Sollte eine stark angepasste Mailvorlage den Block verschlucken, kann er alternativ direkt in die Vorlage „Bestellbestätigung“ (Admin → E-Mail-Vorlagen) eingefügt werden.
Ehrliche Grenzen
- Nur EUR / SEPA: EPC-QR ist SCT-only. Fremdwährungsbestellungen bekommen keinen QR.
- Kein Zahlungsabgleich: Das Plugin zeigt Zahlungsdaten an — ob/wann gezahlt wurde, erkennt weiterhin nur die Wawi bzw. der Kontoabgleich.
- Betrag = Bestellsumme zum Bestellzeitpunkt: Nachträgliche Änderungen in der Wawi spiegeln sich nicht rückwirkend.
- Teilstring-Match kann übermatchen: „Überweisung“ matcht auch „Sofortüberweisung“ — möglichst eindeutige Fragmente verwenden.
- Eine Bankverbindung shopweit — keine Bankverbindung je Zahlungsart/Mandant.
Häufige Fragen
Warum sehe ich keine QR-Box?
Prüfen Sie den Selbstcheck (gültige IBAN?), die Zahlungsart-Namensliste sowie, ob die Bestellung noch unbezahlt ist.
Funktioniert das auch ohne JavaScript?
Die Zahlungsdaten stehen immer als Text daneben — nur der QR-Code selbst entfällt ohne JavaScript.
Support
webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org