VibeFox eWAY for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer, mit der cURL-Erweiterung.

Währung: AUD, NZD, SGD, HKD oder MYR. Bei anderen Kassenwährungen wird die Zahlungsart an der Kasse ausgeblendet. Die Zahlung wird in der Bestellwährung belastet.

eWAY-Konto: Sie benötigen ein eWAY-Händlerkonto mit Zugriff auf die Rapid API sowie den Rapid-API-Schlüssel und das Passwort; beides finden Sie in MyeWAY unter Settings, API Key. Zum Testen benötigen Sie ein eWAY-Sandbox-Konto mit eigenem Schlüssel und Passwort. Sandbox- und Live-Schlüssel sind verschieden. In MyeWAY muss nichts eingerichtet werden: Die Return URL wird bei jeder Zahlung übermittelt.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das Paket für OpenCart 3 wcp_eway_payment_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_eway_payment_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen derselbe.

OpenCart 3

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_eway_payment_gateway-oc3-(version).ocmod.zip. Die Erweiterung enthält keine OCMOD-Änderungen, daher muss Extensions > Modifications nicht aktualisiert werden. Statt des Installers können Sie auch den Inhalt des Ordners upload dieses Pakets in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox eWAY Payment Gateway und klicken Sie auf Install (die grüne +-Schaltfläche). Ihr Admin-Benutzer benötigt das Recht, die Liste der Zahlungserweiterungen zu ändern.

3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen. Fügen Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite in License key ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie Ihren Sandbox-API-Schlüssel und das Sandbox-API-Passwort ein, lassen Sie Sandbox Mode eingeschaltet, aktivieren Sie Enable/Disable, klicken Sie auf Save und legen Sie eine Testbestellung an.

5. Geben Sie Ihren Live-API-Schlüssel und das Live-API-Passwort ein, deaktivieren Sie Sandbox Mode und klicken Sie auf Save.

6. Optional können Sie die auf der Einstellungsseite angezeigte Cron-URL in die Cron-Jobs Ihres Servers eintragen (siehe Konfiguration).

OpenCart 4

1. Gehen Sie im Admin zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_eway_payment_gateway.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 entnimmt den Code der Erweiterung dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Typ Payments. Suchen Sie VibeFox eWAY Payment Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und dann auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel, die eWAY-Schlüssel und die Cron-URL ein, wie in den Schritten 3 bis 6 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Cron-URL ist anders (siehe Re-check of lost returns (cron)).

Eine neue Installation startet mit deaktivierter Zahlungsart und aktiviertem Sandbox-Modus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox eWAY Payment Gateway > Edit. Die Bereiche sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt ein Hinweis den Modus an: SANDBOX — payments go to the eWAY sandbox, no real money is charged. oder LIVE — real payments are taken with the live API key. Die Seite warnt Sie, wenn Schlüssel oder Passwort der API für den aktuellen Modus fehlen (die Zahlungsart wird dann an der Kasse nicht angezeigt), und wenn die Standardwährung des Shops von eWAY nicht unterstützt wird. Ohne das Recht, die Erweiterung zu bearbeiten, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern muss Title 1 bis 128 Zeichen lang sein, Sort Order muss eine ganze Zahl sein, Total darf nicht negativ sein, und die gewählte Geozone sowie die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert, und die Seite zeigt, was zu korrigieren ist.

eWAY

Enable/Disable: Enable eWAY Payment Gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Credit Card (eWAY). Pflichtfeld, bis zu 128 Zeichen.

Description: der Text, den der Kunde im Schritt Confirm Order über der Bestätigungsschaltfläche sieht. Standard: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.

Sort Order: die Position von eWAY unter den Zahlungsarten an der Kasse. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein.

Geo Zone: eWAY nur für Rechnungsadressen in der gewählten Geozone anbieten. Standard: All zones. Geozonen richten Sie unter System > Localisation > Geo Zones ein.

Total: der Betrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, damit eWAY angeboten wird. Lassen Sie das Feld leer, um eWAY bei jedem Betrag anzubieten.

API-Zugangsdaten

Rapid-API-Schlüssel und Passwort finden Sie in MyeWAY unter Settings, API Key. eWAY stellt Anleitungen für Live- und Sandbox-Schlüssel bereit, die in diesem Bereich verlinkt sind. Sandbox- und Live-Schlüssel sind verschieden. Der Sandbox-Modus verwendet nur die Sandbox-Zugangsdaten, der Live-Modus nur die Live-Zugangsdaten.

Sandbox Mode: Zahlungen gehen mit Sandbox-Schlüssel und -Passwort an die eWAY-Sandbox. Es wird kein echtes Geld belastet. Standard: an. Schalten Sie es aus, um Live-Zahlungen mit dem Live-Schlüssel anzunehmen. Solange es aktiviert ist, sieht der Kunde im Schritt Confirm Order den Hinweis Test mode: no real payment is taken.

Live API Key: der Rapid-API-Schlüssel Ihres eWAY-Live-Kontos.

Live API Password: das Rapid-API-Passwort Ihres eWAY-Live-Kontos.

Sandbox API Key: der Rapid-API-Schlüssel Ihres eWAY-Sandbox-Kontos (Partner- bzw. Entwicklerkonto).

Sandbox API Password: das Rapid-API-Passwort Ihres eWAY-Sandbox-Kontos.

Gespeicherte Schlüssel und Passwörter werden nie wieder angezeigt. Das Feld bleibt leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um einen gespeicherten Wert zu entfernen, setzen Sie unter dem Feld den Haken bei Clear the saved value on save und klicken Sie auf Save.

Return URL: zeigt die Rückkehr-Adresse der Erweiterung. Sie wird bei jeder Zahlung automatisch zusammen mit der Bestellung und einem Zufallsschlüssel des Zahlungsversuchs an eWAY übermittelt, daher muss in MyeWAY nichts eingerichtet werden. Das Ergebnis einer Zahlung wird immer serverseitig direkt bei eWAY abgefragt.

Re-check of lost returns (cron): eine optionale Cron-URL, die unter der Return URL angezeigt wird. Rufen Sie sie über einen Cron-Job Ihres Servers alle 15 Minuten auf, zum Beispiel mit curl. Schließt der Kunde nach der Zahlung den Browser, bevor er in den Shop zurückkehrt, wird etwa 60 Minuten nach der Weiterleitung zu eWAY der Zahlungsstatus bei eWAY abgefragt und die Bestellung aktualisiert. Ist eWAY nicht erreichbar, wird die Prüfung bis zu dreimal wiederholt. Halten Sie diese URL vertraulich: Sie enthält ein bei der Installation erzeugtes geheimes Token, und ein Aufruf mit falschem Token wird mit Forbidden beantwortet. Auf OpenCart 4 sieht die URL so aus: https://your-store/index.php?route=extension/wcp_eway_payment_gateway/payment/wcp_eway_payment_gateway.cron&token=(token).

Bestellungen

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (fehlende Bestellung). Sie erhält erst dann einen Status, wenn eWAY die Zahlung bestätigt hat. Jedes der folgenden Felder enthält Ihre OpenCart-Bestellstatus.

Order Status on Success: der Status, der gesetzt wird, sobald eWAY die Zahlung bestätigt. Standard: In Bearbeitung.

eWAY payment on hold status: der Status für eine genehmigte Zahlung, die Ihre Prüfung braucht: Betrag oder Währung stimmen nicht mit der Bestellung überein, die Zahlung wurde genehmigt, nachdem der Kunde auf der eWAY-Seite auf Cancel geklickt hatte, oder die Bestellung hatte bereits einen anderen Status. Eine Notiz im Bestellverlauf erklärt den Grund. Standard: Ausstehend, da OpenCart keinen Status „On hold“ hat. Einen eigenen Status legen Sie unter System > Localisation > Order Statuses an und wählen ihn hier aus.

Refunded order status: der Status, nachdem die Zahlung auf der Bestellseite vollständig erstattet wurde. Standard: Erstattet.

Erweitert

Debug log: schreibt API-Aufrufe und Zahlungsergebnisse in eway_p_debug.log.php im Protokollordner von OpenCart (storage/logs). Die Datei lässt sich nicht über das Web öffnen; bei 5 MB wird sie nach eway_p_debug.old.log.php verschoben. Kartendaten, Schlüssel, Passwörter, E-Mail-Adressen der Kunden und Zugriffscodes werden nicht protokolliert. Fehler werden immer protokolliert. Standard: aus.

Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Delete all extension data on uninstall: Wenn aktiviert, werden beim Deinstallieren der Erweiterung die Einstellungen der Zahlungsart und das Protokoll gelöscht. Die eWAY-Zahlungs- und Erstattungsdaten der Bestellungen bleiben immer erhalten. Standard: aus.

Importieren / Exportieren

Export: Download JSON speichert die Einstellungen als JSON-Datei. API-Schlüssel und Passwörter werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Gespeicherte API-Schlüssel und Passwörter bleiben erhalten.

Kasse

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit Card (eWAY)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung und den Hinweis You will be redirected to the secure eWAY payment page to pay by card. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Auf OpenCart 4 wählt der Kunde die Zahlungsart mit der Schaltfläche Choose im Block der Zahlungsart im Fenster Payment method options und klickt unten auf der Kassenseite auf Confirm Order. Wenn der Kunde auf Confirm Order klickt, fordert die Erweiterung bei eWAY eine Zahlungsseite für den Bestellbetrag in der Bestellwährung an, mit OC- und der Bestellnummer als Rechnungsreferenz sowie der Rechnungsadresse und der E-Mail-Adresse des Kunden, und leitet den Kunden zur eWAY Responsive Shared Page weiter. Dort bezahlt der Kunde mit Karte. Die Zahlung wird sofort erfasst.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Erweiterung vertraut dem Browser nicht: Sie fragt das Ergebnis der für diese Bestellung erstellten Zahlungsseite serverseitig bei eWAY ab. Die Bestellung wird erst als bezahlt markiert, wenn eWAY es bestätigt und der genehmigte Betrag und die Währung mit der Bestellung übereinstimmen. Die Bestellung erhält ihren Status dann auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Bei einer Bestellung in der Prüfung zeigt die Seite zusätzlich Your payment was received and is being reviewed by the store. We will contact you if anything is needed.

Kann eWAY in diesem Moment nicht abgefragt werden, zeigt eine Seite Payment confirmation den Text We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. mit einer Schaltfläche Check again und einer Schaltfläche Back to checkout. Die Bestellung erhält ihren Status, wenn der Kunde erneut prüft oder wenn die Cron-URL ausgeführt wird.

Wird die Zahlung abgelehnt, kehrt der Kunde mit dem Grund zur Kasse zurück, zum Beispiel Your payment was declined: D4451 Insufficient funds. Please try again or use a different payment method. Die Bestellung bleibt ohne Status. Klickt der Kunde auf der eWAY-Seite auf Cancel, prüft die Erweiterung zuerst bei eWAY, ob nichts bezahlt wurde (etwa in einem anderen Tab). Danach sieht der Kunde You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. Wurde die Zahlung nicht abgeschlossen, lautet die Meldung The payment was not completed. Please try again. Der Warenkorb bleibt in jedem Fall erhalten. Auf OpenCart 4 werden diese Meldungen über der Kassenseite angezeigt.

Der Kunde kann es erneut versuchen. OpenCart 3 legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an, OpenCart 4 aktualisiert dagegen die Bestellung der Kasse, sodass ein neuer Versuch eine neue eWAY-Zahlungsseite für dieselbe Bestellung öffnet. Vor einer neuen Zahlungsseite werden die bisherigen Seiten dieser Bestellung und anderer Bestellungen desselben Warenkorbs bei eWAY geprüft. Ist eine davon bereits bezahlt, wird diese Zahlung bestätigt, statt eine zweite zu verlangen. Kann eWAY dazu nicht abgefragt werden, sieht der Kunde We could not check the status of your previous payment attempt. Please try again in a moment. Kann eWAY die Zahlungsseite nicht erstellen, bleibt der Kunde im Schritt Confirm Order mit einer kurzen Meldung, zum Beispiel Payment error: Unable to connect to eWAY. Please try again. oder eWAY could not start the payment mit den Fehlercodes von eWAY.

OpenCart 4 behält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel von Ihnen storniert), wird der Kunde mit dem Hinweis Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. zurück zur Kasse geschickt, und das nächste Confirm Order bezahlt eine neue Bestellung des Warenkorbs. Ist die Bestellung bereits bezahlt, der Warenkorb seitdem aber geändert, auch durch eine neue Menge, lautet die Meldung Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. Eine bezahlte Bestellung wird nie als bezahlt für einen anderen Warenkorb angezeigt.

Die Rückkehr- und Cron-URLs funktionieren auch, während der Shop im Wartungsmodus ist, da OpenCart 3 Anfragen von Zahlungserweiterungen durchlässt und die Erweiterung auf OpenCart 4 dafür eine Startaktion hinzufügt.

eWAY sendet für die Shared Page keine Benachrichtigungen von Server zu Server: Das Ergebnis wird bei der Rückkehr des Kunden und über die Cron-URL abgerufen. Die Erweiterung hat keine Kartenfelder auf Ihrer Website, keine gespeicherten Karten oder Abonnements, keine reine Autorisierung und keine nachträgliche Erfassung, und sie wertet keine Beagle-Betrugsbewertungen aus (Transaktionen, die von den Betrugsregeln von eWAY blockiert werden, lehnt eWAY selbst ab).

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde wurde zu eWAY weitergeleitet und hat nicht bezahlt, abgebrochen, die Zahlung wurde abgelehnt, oder das Ergebnis konnte noch nicht abgerufen werden. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status on Success (default Processing): Die Zahlung wurde genehmigt. Eine Notiz zeigt die eWAY-Transaktions-ID, den Autorisierungscode, die Antwort und den Modus (Sandbox oder Live).

eWAY payment on hold status (default Pending): eWAY hat einen anderen Betrag oder eine andere Währung genehmigt als die Bestellung (zum Beispiel Approved for partial amount), die Zahlung wurde genehmigt, nachdem der Kunde sie auf der eWAY-Seite storniert hatte, oder sie wurde für eine Bestellung genehmigt, der bereits ein Status zugewiesen war, zum Beispiel Storniert. Der tatsächlich von eWAY eingezogene Betrag wird vermerkt, und die Notiz erklärt es. Prüfen Sie die Bestellung und wickeln Sie sie ab oder erstatten Sie die Zahlung.

Refunded order status (default Refunded): Die Zahlung wurde über die Erweiterung vollständig erstattet.

Wird für eine bereits bezahlte Bestellung oder für eine andere Bestellung desselben Warenkorbs eine zweite Zahlung genehmigt, bleibt die bezahlte Bestellung unverändert. Eine Notiz fordert Sie auf, das Duplikat in MyeWAY zu erstatten. Eine genehmigte Zahlung für eine andere Rechnungsreferenz wird nie auf die Bestellung angewendet.

Notizen sind Einträge im History der Bestellung, die der Kunde nicht sieht.

Registerkarte VibeFox eWAY Payment Gateway

Öffnen Sie unter Sales > Orders eine mit eWAY bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt die Registerkarte VibeFox eWAY Payment Gateway die eWAY transaction-ID mit der Kennzeichnung Sandbox oder Live, den Auth code, die Response von eWAY, die Invoice reference, den Status der Zahlung, die Beträge Paid / refunded, das Erstattungsformular, den Erstattungsverlauf und die eWAY notes der Bestellung. Die Registerkarte wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie in der Registerkarte den Betrag ein (der noch nicht erstattete Betrag ist vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via eWAY. Bestätigen Sie die Frage Refund this amount through eWAY? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu bearbeiten (festgelegt unter System > Users > User Groups). Erstattungen erfolgen in dem Betrag und in der Währung, die eWAY belastet hat. Nach einer Genehmigung für einen Teilbetrag können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich gezahlt hat, nicht den Bestellbetrag. Die Erstattung wird in der Umgebung gesendet, in der die Zahlung erfolgte (Sandbox oder Live); daher müssen Schlüssel und Passwort der API dieser Umgebung gesetzt sein. Lehnt eWAY die Erstattung ab, zeigt die Registerkarte eWAY refund failed: mit den Codes von eWAY, und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung wird mit der eWAY-Transaktions-ID der Erstattung im Erstattungsverlauf und in den Notizen vermerkt. Eine vollständige Erstattung setzt die Bestellung auf den Status Refunded order status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie eine manuelle Statusänderung. Eine Teilerstattung ändert den Status nicht. Erstattungen sind verfügbar, sobald eWAY die Zahlung genehmigt hat.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über eWAY. In MyeWAY vorgenommene Erstattungen werden nicht nach OpenCart zurückgemeldet. Aktualisieren Sie die Bestellung bei Bedarf manuell.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox eWAY Payment Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox eWAY Payment Gateway > Edit, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zur erneuten Statusprüfung, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-payment-eway und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Admin-Benutzer mit dem Recht Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Shop-Adresse aus der OpenCart-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird eWAY Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im Admin im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf OpenCart 4 gibt es diese Vorschau nicht: Der Shop erkennt die Anmeldung im Admin nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint auf dem Admin-Dashboard eine Erinnerung. Schließen Sie sie mit ×, um sie 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch erneut geprüft, wenn Sie das Admin-Dashboard oder die Seite Edit öffnen: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Beim Deinstallieren der Erweiterung werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

eWAY does not appear at checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Schlüssel und Passwort der API für den aktuellen Modus gesetzt sind (die Sandbox-Felder im Sandbox-Modus, die Live-Felder im Live-Modus) und die Kassenwährung AUD, NZD, SGD, HKD oder MYR ist. Die Einstellungsseite zeigt eine Warnung, wenn die Zugangsdaten fehlen. Prüfen Sie außerdem, ob die Rechnungsadresse in der gewählten Geo Zone liegt und ob die Bestellung den in den Einstellungen festgelegten Total erreicht.

The payment went through, but the order stays without a status: Der Kunde ist nicht von eWAY zurückgekehrt, oder eWAY konnte in diesem Moment nicht abgefragt werden. eWAY sendet keine Benachrichtigungen für die Shared Page. Richten Sie die Cron-URL unter Re-check of lost returns (cron) ein: Sie holt die Zahlung etwa eine Stunde später ab. Prüfen Sie die Transaktion in MyeWAY und sehen Sie im Feld Log auf der Erweiterungsseite nach.

The cron URL answers Forbidden: Das Token in der URL ist falsch. Kopieren Sie die URL genau so, wie die Einstellungsseite sie anzeigt.

The customer sees This payment method is temporarily unavailable: Schlüssel oder Passwort der API für den aktuellen Modus fehlen, oder eWAY hat sie abgelehnt. Prüfen Sie die Zugangsdaten des aktuellen Modus.

The customer sees eWAY could not start the payment: eWAY hat Fehlercodes zurückgegeben, die in der Meldung angezeigt werden. Oft sind die Rechnungsdaten ungültig.

The customer sees eWAY cannot take payments in a currency: Die Bestellwährung wird von eWAY nicht unterstützt. Verwenden Sie AUD, NZD, SGD, HKD oder MYR.

The customer sees We could not match this payment to an order: Der Rücksprunglink gehört nicht zu einer Bestellung dieses Shops, oder eWAY hat eine Zahlung für eine andere Rechnungsreferenz genehmigt. Wurde der Kunde belastet, suchen Sie die Zahlung in MyeWAY.

The customer sees This payment method is not available: Die Sitzung der Kasse passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen deaktiviert. Der Kunde lädt die Kasse neu.

Order is in the on hold status after payment: Lesen Sie die eWAY notes in der Registerkarte VibeFox eWAY Payment Gateway (siehe Bestellstatus) und wickeln Sie danach die Bestellung ab oder erstatten Sie die Zahlung.

No refund form in the tab: Die Registerkarte nennt den Grund: Für die Bestellung wurde keine eWAY-Transaktions-ID gefunden, die Bestellung ist vollständig erstattet, Ihre Benutzergruppe hat kein Recht zur Bearbeitung der Erweiterung, oder die API-Zugangsdaten des Modus der Zahlung sind nicht gesetzt.

Refund fails with a message about the sandbox or live mode: Die Bestellung wurde in dieser Umgebung bezahlt, und deren Schlüssel und Passwort der API sind nicht gesetzt. Geben Sie sie ein und versuchen Sie es erneut.

Refund fails with at most … can be refunded: Der Betrag ist höher als der von eWAY belastete Betrag abzüglich bereits erfolgter Erstattungen.

Für Entwickler löst die Erweiterung die OpenCart-Ereignisse wcp_eway_payment_gateway_supported_currencies (falls Ihr eWAY-Konto für weitere Währungen freigeschaltet ist) und wcp_eway_payment_gateway_create_access_code_request (der Anfragetext, bevor die Zahlungsseite erstellt wird) aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox eWAY Payment Gateway auf Uninstall (die rote −-Schaltfläche). Lizenzschlüssel und Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total sowie die Bestellstatus im Bereich Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückkehren. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 auch deren Ereignisse und ihre Startaktion, die die Rückkehr- und Cron-URLs im Wartungsmodus durchlässt). Ist Delete all plugin data on uninstall aktiviert, werden die übrigen Einstellungen der Zahlungsart (Titel, Beschreibung, Sandbox-Modus, API-Schlüssel und Passwörter, Schalter für das Debug-Protokoll, Cron-Token) und das Protokoll entfernt. Ist die Option deaktiviert, bleiben sie für eine spätere Neuinstallation erhalten. Die eWAY-Zahlungs- und Erstattungsdaten bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Um auf OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox eWAY Payment Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und dann auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

eWAY ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit eWAY verbunden und wird von eWAY weder unterstützt noch empfohlen.