| Info |
|---|
This documentation is also available in english. Nets Easy (English) |
...
Nets (Network for Electronic Transfers) ist Teil der Nexi Group und bietet einfache, schnelle und sichere Zahlungslösungen an. Ein Charge kann als Zahlungseinzug eines zuvor reservierten Betrages aufgefasst werden.
Das Nets Easy Plugin ermöglicht es Zahlungen über Nets Easy anzubieten.
...
Stornieren aus der WAWI
Automatischer Full-Charge bei Teilversand oder Komplettversand
Installation / Update
Systemvoraussetzungen
JTL-Shop 5.00+
Begriffsklärung
Ein reservierter Betrag ist zum Zahlungseinzug reserviert/autorisiert, aber es wurde darauf noch keine Zahlung eingezogen.
Ein Charge kann als Zahlungseinzug eines zuvor reservierten Betrages aufgefasst werden. Entsprechend bedeutet Full-Charge, dass der gesamte Bestellbetrag eingezogen wird.
Ein Refund ist eine Erstattung einer zuvor erfolgten Charge.
Ein Cancel ist der Abbruch einer reservierten Zahlung vor dem Zahlungseinzug.
Installation / Update
Systemvoraussetzungen
JTL-Shop 5.0.0 und dessen Voraussetzungen
...
Die Installation des Plugins erfolgt nach JTL-Standard, wie es hier beschrieben ist oder sie können Ihre vorhandene ZIP-Datei des Plugins auch über den Reiter “Upload“ in der Pluginverwaltung bereitstellen und anschließend im Reiter “Vorhanden“ die Installation starten.
Wir empfehlen die Installation über den JTL-Extension-Store, damit Sie regelmäßig auf Updates hingewiesen werden und diese per Knopfdruck ausführen können.
Plugin-Update
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.
...
Die Konfiguration der Zahlungsart erfolgt über die Standard-Verwaltung im JTL-Shop. Sie finden die Zahlungsarten unter Administration → Zahlungsarten. Einen direkten Link dahin finden Sie auch auf der Hilfe-Seite des Plugins. Wählen Sie Nets Easy über das Stift-Symbol aus und konfigurieren Sie die Zahlungsmethode bei Bedarf.
Plugin-Einstellungen
Neben den Standard-Einstellungen für Zahlungsarten befinden sich im Plugin unter Einstellungen die Einstellungen zur Zahlungsart.
Hier können Sie die für den Betrieb im Plugin notwendigen Daten aus ihrem Nets Easy Account hinterlegen.
...
Option | Beschreibung |
|---|---|
Plugin aktiv | Hier können Sie das Plugin außerhalb der Pluginverwaltung aktivieren oder deaktivieren.Live Secret . |
Live Secret Key | Der API-Schlüssel für den Live-Modus. Sie finden diesen Schlüssel in Ihrem Nets Easy Account unter “Company > Integration > Live Environment > Secret key” |
Live Checkout Key | Der APICheckout-Schlüssel für den Live-Modus. Diesen finden Sie finden diesen Schlüssel ebenfalls in Ihrem Nets Easy Account unter “Company > Integration > Live Environment > Secret key”. |
Test Secret Key | Der API-Schlüssel für den Test-Modus. Sie finden diesen Schlüssel in Ihrem Nets Easy Account unter “Company > Integration > Test Environment > Secret key” |
Test Checkout Key | Der Checkout-Schlüssel für den Test-Modus. Diesen finden Sie ebenfalls in Ihrem Nets Easy Account. |
Plugin Modus | Wählen Sie hier den Betriebsmodus aus Test - das Plugin befindet sich im Test-Modus und kommuniziert mit der Sandbox. Es erfolgen keine echten Zahlungen. Live - das Plugin ist im Live-Modus und akzeptiert reelle führt echte Zahlungen aus. |
Checkout Modus | Wählen Sie hier den Checkout Modus aus Hosted - die Kunden werden auf eine externe Nets Easy Seite weitergeleitet und schließen dort den Bezahlvorgang ab. Danach erfolgt eine Weiterleitung zurück auf den Shop. Embedded - zum Abschluss des Bestellvorganges wird ein iFrame unterhalb der Warenübersicht Warenkorbübersicht auf der Zusammenfassungsseite angezeigt. Nach erfolgreicher Zahlung wird der Kunde auf die Bestellabschlussseite geleitet. Hierfür sind möglicher Weise möglicherweise weitere Einstellungen nötig. (Siehe Tab 2. 2) |
Optionale AGB-URL | Ist eine optionale AGB-URL hinterlegt wird diese an Nets Easy übergeben und im Checkbox Text gesetzt. Ist diese nicht angegeben, dann wird die AGB-URL des Shops verwendet. |
Optionale Datenschutz-URL | Ist eine optionale Datenschutz-URL hinterlegt wird diese an Nets Easy übergeben und im Checkbox Text gesetzt. |
Zahlungseinzug | Diese Option beschreibt, wann ein Charge durchgeführt wird: manuell - es werden keine Charges durchgeführt, der Händler muss über das Plugin oder dem Nets Easy Backend den Charge auslösen sofort - ein Full-Charge wird umgehend nach der Reservierung bei Nets Easy durchgeführt erster Teilversand - nach dem Wawi Abgleich wird bei einem Teilversand beim ersten Versand (egal ob Teilversand oder Komplettversand) ein Full-Charge bei Nets Easy durchgeführt. Komplettversand - nach dem Wawi Abgleich wird bei einem Komplettversand ein Full-Charge bei Nets Easy durchgeführt. Hinweis: Bei manchen Zahlungsarten (zum Beispiel SOFORT ÜB) wird die Zahlung immer sofort ausgeführt, unabhängig von dieser Einstellung. |
E-Mail bei Zahlungsfehler | Alternative E-Mail-Adresse des Shop-Administrators. Ist eine E-Mail-Adresse hinterlegt, dann wird bei Fehlern beim Charge oder Refund eine automatische E-Mail versendet. Anderenfalls wird zum Versand die Shop Master E-Mail-Adresse verwendet. |
Mail Template Sprache | Wählen Sie hier die Sprache in der die Benachrichtigungs-Emails versendet werden sollen. Wählen Sie Deutsch, dann werden die E-Mails in Deutsch versendet. Gleiches gilt für Englisch. |
Debug Frontend | Aktivieren Sie erweiterte Logs im Shop-Log für das Frontend. Dies fügt weitere, detaillierte Log-Meldungen im Debug-Log hinzu. |
Debug Backend | Aktivieren Sie erweiterte Logs im Shop-Log für das Backend. Dies fügt weitere, detaillierte Log-Meldungen im Debug-Log hinzu. |
Tab. 1
Option | Beschreibung |
|---|---|
PHP Query Selektor | Geben Sie hier eine alternative Klasse oder ID des Elementes im DOM an an, in das der Embedded Checkout gebunden werden soll. Ist der Embedded Checkout ausgewählt, dann wird immer der “Zahlungspflichtig Bestellen“-Button ausgeblendet. Achten Sie darauf, stets ein gültiges Element anzugeben, sonst wird der Embedded Checkout nicht angezeigt und der Kunde kann keine Bestellung mit Nets Easy abschließen. |
PHP Query Methode | Geben Sie hier die Methode an in welcher Art und Weise der Embedded Checkout eingebunden werden soll. after - der Checkout wird nach dem angebenden Element angefügt before - der Checkout wird vor dem angebenden Element angefügt append - der Checkout wird an das angebende Element angehängt prepend der Checkout wird an das angebende Element vorangestellt replaceWith - das angegebene Element wird mit dem Checkout ersetzt |
PHP Query Elemente ausblenden | Geben Sie hier die Elemente im DOM an, welche beim Embedded Checkout ausgeblendet werden sollen. Im Standard wird stets das Element “#complete-order-button“ (der Zahlungspflicht Bestellen-Button des JTL-Shop) ausgeblendet. Wenn ihre ID des Buttons anders bezeichnet ist, dann können Sie hier ihren eigenen Selektor angeben. Fragen Sie ggf. bei Ihrem Template-Entwickler/-Anbieter nach. |
Tab. 2
Versandarten
Weisen Sie nun Nets Easy den gewünschten Versandarten/Ländern unter Administration → Versand zu. Das Plugin berücksichtigt auch etwaige Aufschläge zur Zahlungsmethode. Einen direkten Link dahin finden Sie auch auf der Hilfe-Seite des Plugins.
...
Legen Sie als Zahlungsart Nets Easy an Online Checkout an, oder eine Zahlungsart mit dem Namen, den Sie als Anzeigenamen im Shop angegeben haben. Beachten Sie, dass die Zahlungsarten in jeder Sprache dem “Angezeigten jeweiligen “angezeigten Namen“ im JTL-Shop entsprechen müssenShop entsprechen müssen, da die Wawi sonst die Zuordnung nicht herstellen kann.
Standardmäßig ist der Zahlungseinzug auf sofort eingestellt. Falls sie Sich jedoch für Zahlungseinzug beim ersten Teilversand oder erst bei Komplettversand entscheiden, dann sind noch weitere Einstellungen erforderlich. Es muss “Auslieferung vor Zahlungseingang möglich“ aktiviert werden. Der Full-Charge wird dann abhängig von den Plugin Einstellungen mit dem nächsten Wawi-Abgleich ausgeführt.
...
Ihr Shop muss die Währungen Dänische Krone, Euro, Britisches Pfund, Norwegische Krone, Schwedische Krone, US-Dollar, Polnische Zloty oder Schweizer Franken unterstützen.
| Info |
|---|
Wird die aktuell ausgewählte Währung nicht unterstützt, dann wird Nets Easy als Zahlungsart nicht angeboten. |
...
Eingehende Bestellungen und mit Nets Easy durchgeführte Zahlungseingänge werden durch Abgleich an die JTL-WAWI übertragen. Über die WAWI können nur die Aktionen Full-Charge (in Abhängigkeit vom Zahlungseinzug) und Cancel (Storno) ausgeführt werden.
Bestellung bezahlen (Full-Charge)
...
Der Full-Charge wird dann im Anschluss an den WAWI-Abgleich bei Nets-Easy durchgeführt.
| Warning |
|---|
+++ ACHTUNG, WICHTIG +++Achten Sie bitte genaustens darauf, dass Sie in der JTL-WAWI nicht aus Versehen eine falsche Bestellung stornieren! Die JTL-WAWI bietet zwar die Möglichkeit eine Stornierung rückgängig zu machen, allerdings werden die von Ihnen durchgeführten Aktionen diesbezüglich 1:1 an den Onlineshop übertragen! In dem Fall würde zuerst die Bestellung storniert und die Zahlung gecancelt werden. Anschließend wäre die Bestellung zwar wieder reaktiviert aber eine Zahlung ist nicht mehr durchführbar! Sollten Sie im Anschluss die Ware versenden, dann erfolgt dies ohne Zahlungseingang! |
Individualisierung
Die Zahlungsart wird in der Standardauswahl der Zahlungsarten im JTL-Shop eingeblendet und hat keine individualisierbaren Elemente an der Stelle.
...
Der Status und die Aktion-Buttons werden nur dann angezeigt, wenn die API-Schlüssel unter Einstellungen eintragen sind. Bitte achten Sie darauf die Schlüssel korrekt zu übertragen, anderenfalls wird Ihnen die Meldung angezeigt:
| Warning |
|---|
Unauthorized |
Warum werden bei machen Zahlungen Erstattungen angeboten und bei anderen nicht?
...
Guthaben wird hier letztendlich als Pseudo-Element der Bestellung einmalig hinzugefügt, um diese Inkonsistenz auszugleichen.
Edge Cases (Randfälle)
Letzter bzw. ausverkaufter Artikel
Es kann passieren, dass Kunden um den letzten Artikel konkurrieren.
Troubleshooting
Sollten Sie Probleme mit dem Plugin beobachten, prüfen Sie zunächst die Logs und wenden Sie sich ggf. an unseren Support oder Ihren Service-Partner, wenn Sie das Problem nicht selbständig lösen können.
...
Diese Meldung wird angezeigt, wenn der Kunde im Nets Easy Checkout auf “< Go back“ geklickt hat und die Zahlung abbricht ohne den Checkout zu durchlaufen.
...
In manchen Fällen kann es dazu kommen, dass die Zahlung nicht sofort bestätigt werden konnte. Dies ist z.B. dann der Fall, wenn es zeitliche Verzögerungen gibt zwischen dem Zurückleiten des Kunden auf die Return-URL und der Verarbeitung der Zahlung. In diesem Fall wird der Kunde auf eine Warteschleife gesetzt. Die Warteschleife prüft periodisch (max. 60 Sekunden) den Eingang eines Callbacks von Nets Easy für die aktuelle Payment-Id. Sollte nach Ablauf der Wartezeit kein Callback über den Webhook eintreffen, dann wird die Zahlung bei Nets Easy storniert und die obige Meldung angezeigt.
| Note |
|---|
Diese Zahlung ist bereits abgebrochen worden |
Diese Meldung wird angezeigt, wenn die Zahlung zwischenzeitlich abgebrochen oder storniert wurde.
| Note |
|---|
| Warning |
Die Bestellung konnte angelegt, Ihre Zahlung allerdings nicht abgeschlossen werden. Bitte wenden Sie sich an den Händler |
Diese Meldung wird angezeigt, wenn die Zahlung zwischenzeitlich abgebrochen oder storniert wurdeder Charge nicht durchgeführt werden konnte. Die Zahlung wurde bei Nets Easy storniert. Prüfen Sie das Shop-Log.
| Warning |
|---|
Der Charge ist fehlgeschlagen |
...
| Warning |
|---|
Achtung: Editieren Sie die Config-Datei des Shops nur, wenn Sie wissen, was Sie tun! Fehlerhafte Anpassungen hier können Ihren Shop unerreichbar oder (verschlüsselte) Daten unbrauchbar machen. Im Zweifelsfall sollten Sie Ihren Hoster oder Servicepartner um Hilfe fragen. |
Changelog
v1.0.3 (Februar 2023)
Fix Bestellungen werden nach erfolgreicher Zahlung nicht angelegt!
v1.0.2 (Januar 2023)
Update Exsid
...