Einleitung

Gini Pay bietet Ihnen die Möglichkeit, im JTL-Shop die Vorkasse Überweisung per QR-Code anzubieten.

Hierdurch werden fehlerhafte Überweisungen vermieden und die einfache Nutzung erlaubt dem Kunden schnell und direkt nach der Bestellung die Überweisung mit seiner bevorzugten Banking App auszuführen.

Features

Dieses Plugin bietet zwei neue Zahlungsarten an:

• Vorkasse Überweisung

• QR-Code Überweisung

Bei der Auswahl der Zahlungsart wird dem Kunden an drei Stellen ein QR-Code angezeigt, den er einfach nutzen kann, um mit seiner Banking App zu überweisen:

• Auf der Bestellbestätigungsseite.

• In der Bestellbestätigungsemail.

• In der Detailansicht der Bestellung im Kundenkonto (bei registrierten Kunden).

Zusätzlich werden die gewohnten, konfigurierten Überweisungsdaten angezeigt, falls der Kunde doch manuell überweisen möchte.

Installation / Update

Systemvoraussetzungen

...

Bei einem Update auf eine neuere Version können Sie der allgemeinen Installation folgen mit dem Unterschied, dass Sie direkt in der Pluginverwaltung den Update-Button zur Aktualisierung betätigen müssen.

Konfiguration

Shop

Einstellungen

Die Einstellungen finden Sie in der Admin-Oberfläche im Reiter Einstellungen.

E-Mail-Templates

Damit der QR-Code auch in der Bestellbestätigungsmail angezeigt werden kann, müssen Sie das Bestellbestätigungsmail-Template anpassen.

Fügen Sie für jede Sprache im HTML-Template den Code ein, wo die Information gezeigt werden soll:

{if isset($giniHtml)}{$giniHtml}{/if}

Fügen Sie für jede Sprache im Text-Template den Code ein, wo die Information gezeigt werden soll:

{if isset($giniText)}{$giniText}{/if}

Zahlungsarteinstellungen

Die Einstellungen zur Zahlungsart entsprechen den Standardeinstellungen in JTL-Shop 5. Bitte ändern Sie nicht die Einstellung Zahlung vor Bestellabschluss, da die Zahlungsart sonst nicht angeboten wird. Die Einstellung muss auf “Nein” stehen.

Sie finden Zahlungsartlogos - falls Sie diese nutzen wollen - im Plugin-Pfad (z.B.: /plugins/s360_gini_shop5/logo.svg).

Versandartzuordnung

Die Zuordnung zu Versandarten entspricht dem Standard von JTL-Shop 5.

ERP-System

Wie bei allen Zahlungsarten, müssen Sie in der JTL-Wawi ebenfalls die Zahlungsarten so anlegen, dass die Namen in der Wawi den Anzeigenamen im Shop entsprechen. Nur so kann die JTL-Wawi die Zuordnung zur Zahlungsart richtig durchführen.

Die Option “Versand vor Zahlungseingang” sollte deaktiviert sein, da es sich um Vorkasse-Zahlungen handelt.

Betrieb

Begriffsklärung / Glossar

Shop

ERP-System

Individualisierung

Sprachvariabelen

...

Shop

Im Plugin-Adminbereich im Reiter Zahlungen können Sie die mit Gini durchgeführten Bestellungen anschauen. Der Gini-Status zeigt Ihnen den Scan-Status von QR-Codes bzw. der Zahlung.

Die Bedeutungen sind dabei (ohne Gewähr, da diese von Gini gesetzt werden):

• open → der QR-Code / Payment Request wurde erstellt und noch nicht in einer Banking-App gescannt.

• qr_scanned → der QR-Code wurde in einer Banking App gescannt, aber noch nicht zwingend zur Auslösung einer Überweisung genutzt.

• paid → der QR-Code wurde genutzt, um eine Überweisung auszulösen. (Achtung: Das bedeutet nicht automatisch, dass Sie auch einen Zahlungseingang erhalten!)

• paid_adjusted → der QR-Code wurde genutzt, um eine Überweisung auszulösen, aber der Kunde hat Veränderungen an den Überweisungsdaten vorgenommen. (Achtung: Das bedeutet nicht automatisch, dass Sie auch einen Zahlungseingang erhalten!)

Das Plugin aktualisiert die Status der Zahlungen nicht proaktiv - wenn Sie den aktuellsten Stand eines Payment-Request sehen wollen, nutzen Sie bitte den “Angezeigte Zahlungen aktualisieren”-Button, um den aktuellen Status von Gini zu holen.

Hinweis: Je nach Integration zwischen Gini und der jeweiligen Bank entsprechen die von Gini gemeldeten Status ggf. nicht dem wirklichen Status. Es kann natürlich auch sein, dass ein Kunde die Überweisung in einer Banking App ohne Nutzung des QR-Codes ausführt, wodurch der Status nie von “open” weggeht, obwohl die Überweisung korrekt ausgeführt wurde. Diese sind daher nur als Anhaltspunkte zu verstehen.

ERP-System

Die Zahlungsart verhält sich aus Wawi-Sicht wie die Standard Vorkasse Überweisung - d.h. Sie müssen die eingehenden Überweisungen per HBCI o.ä. zu der Bestellung zuweisen - es erfolgt kein automatisches Setzen der Zahlung durch das Plugin weil das Plugin im Shop schlichtweg nicht weiß, ob eine Überweisung tatsächlich ausgeführt worden ist oder nicht.

Ebenso erfolgen Erstattungen etc. wie bei der Standard Vorkasse Überweisung und gehen nicht über das Plugin.

Individualisierung

Sie können Teile der Plugin-Ausgaben bei Bedarf auch individualisieren. Beachten Sie dabei, dass Sie nach Updates des Plugins Ihre Änderungen ggf. nachziehen müssen.

Sprachvariablen

Die Sprachvariablen finden Sie wie üblich im JTL-Shop 5 im Plugin-Manager in der Liste der installierten Plugins.

Templates

Die Template-Dateien im Pfad plugins/s360_gini_shop5/frontend/template sind individualisierbar, indem Sie eine *_custom.tpl in denselben Ordner legen.

Die CSS-Dateien werden auch über die Template-Dateien eingebunden - so können Sie hier auch Styles überschreiben.

Die Template-Dateien sind wie folgt unterteilt:

• frontend.tpl → Anzeige im Bestellabschluss und in der Bestellansicht im Kundenkonto

• email.tpl → HTML-Snippet für den HTML-Teil der Bestellbestätigungsmail

• email_plain.tpl → Text-Snippet für den Text-Teil der Bestellbestätigungsmail

Troubleshooting

Logs prüfen

...

FAQ

Warum kommt das Plugin mit 2 Zahlungsarten, die identisch funktionieren?

Beide Zahlungsarten funktionieren zwar identisch, aber so können Kunden bei der Zahlungsartauswahl offensiver auf die Möglichkeit der QR-Code Überweisung hingewiesen werden, ohne die “bekannte” Vorkasse für weniger technisch versierte Kunden zu entfernen.

Es steht Ihnen natürlich frei, nur eine der beiden Zahlungsarten oder beide gleichzeitig zu nutzen.

Changelog

v1.0.0 (Dezember 2024)

...