VibeFox eWAY for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv.

PHP: 8.0 oder neuer.

Shopwährung: AUD, NZD, SGD, HKD oder MYR. Bei anderen Währungen wird die Zahlungsart an der Kasse ausgeblendet. Die Bestellung wird in ihrer eigenen Währung belastet.

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

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins aus und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_eway_payment_gateway per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > eWAY > Manage oder klicken Sie auf der Plugins-Seite unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Geben Sie Ihren Sandbox-API-Schlüssel und das Passwort ein, lassen Sie Sandbox Mode aktiviert, schalten Sie Enable/Disable ein und führen Sie eine Testbestellung mit der eWAY-Testkarte 4444333322221111 durch.

6. Geben Sie Ihren Live-API-Schlüssel und das Passwort ein, deaktivieren Sie Sandbox Mode und speichern Sie.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > eWAY. Oberhalb der Felder zeigt ein Abzeichen den Modus an: SANDBOX (Zahlungen gehen an die eWAY-Sandbox, es wird kein echtes Geld belastet) oder LIVE (echte Zahlungen werden mit dem Live-API-Schlüssel abgewickelt). Die Seite warnt, wenn Schlüssel und Passwort des aktuellen Modus fehlen (dann wird das Gateway an der Kasse nicht angezeigt) und wenn die Shopwährung nicht unterstützt wird. In der Liste der Zahlungsarten ist eWAY als einrichtungsbedürftig markiert, bis der aktuelle Modus Zugangsdaten hat, und im Sandbox-Modus wird ein Testmodus-Abzeichen angezeigt.

Allgemein

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. Standard: Credit Card (eWAY).

Description: der Text, der an der Kasse unter der Zahlungsart angezeigt wird. Standard: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.

API-Zugangsdaten

Der Rapid-API-Schlüssel und das Passwort finden Sie in MyeWAY unter Settings, API Key. eWAY stellt Anleitungen für Live- und Sandbox-Schlüssel bereit, die in diesem Abschnitt verlinkt sind. Sandbox und Live verwenden unterschiedliche Schlüssel.

Sandbox Mode: Enable sandbox (test) mode sendet Zahlungen mit dem Sandbox-Schlüssel an die eWAY-Sandbox. Es wird kein echtes Geld belastet. Standard: an. Deaktivieren Sie die Option, um Live-Zahlungen mit dem Live-Schlüssel abzuwickeln.

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/developer).

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

Bestellungen

Order Status on Success: der Bestellstatus, sobald eWAY die Zahlung bestätigt.

Erweitert

Debug log: Enable logging schreibt API-Aufrufe und Zahlungsergebnisse nach WooCommerce > Status > Logs, Quelle wcp_eway_payment_gateway. Kartendaten und Schlüssel werden nicht protokolliert. Fehler werden immer protokolliert. Standard: aus.

Uninstall: Delete all plugin data on uninstall. Ist die Option aktiviert, werden beim Löschen des Plugins die Gateway-Einstellungen und seine Protokolle entfernt. Die auf Bestellungen gespeicherten Zahlungsreferenzen bleiben erhalten. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Credit Card (eWAY)) und gibt die Bestellung auf. Das Plugin fordert bei eWAY eine Zahlungsseite für den Gesamtbetrag der Bestellung in der Bestellwährung an, mit der Bestellnummer als Rechnungsreferenz und den Rechnungsdaten des Kunden, und leitet den Kunden zur Responsive Shared Page von eWAY weiter. Dort bezahlt der Kunde mit Karte. Die Zahlung wird sofort erfasst.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Das Plugin vertraut dem Browser nicht: Es fragt bei eWAY serverseitig das Ergebnis der Zahlungsseite ab, die diese Bestellung erstellt hat. Die Bestellung wird erst als bezahlt markiert, wenn eWAY die Zahlung bestätigt und der genehmigte Betrag sowie die Währung mit der Bestellung übereinstimmen. Danach landet der Kunde auf der Seite „Bestellung eingegangen“. Konnte eWAY in diesem Moment nicht abgefragt werden, bleibt die Bestellung auf „Zahlung ausstehend“, und die Seite zeigt 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. Die Zahlung wird beim Aufrufen der Seite „Bestellung eingegangen“ und vor der automatischen Stornierung der unbezahlten Bestellung durch WooCommerce erneut geprüft.

Wird die Zahlung abgelehnt, kehrt der Kunde zur Kasse (oder zur Seite Pay for order) zurück und sieht den Grund, zum Beispiel Your payment was declined: Insufficient funds. Please try again or use a different payment method. Klickt der Kunde auf der eWAY-Seite auf Cancel, prüft das Plugin zuerst bei eWAY, dass nichts bezahlt wurde. Eine an der Kasse aufgegebene Bestellung wird dann storniert, eine über die Seite Pay for order bezahlte Bestellung bleibt unbezahlt. Der Kunde sieht 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.

Ein Kunde kann eine unbezahlte Bestellung erneut bezahlen. Jede Zahlungsseite der Bestellung wird erfasst, sodass auch die Zahlung über eine ältere Seite erkannt wird. Kann eWAY die Zahlungsseite nicht erstellen, sieht der Kunde eine kurze Meldung, zum Beispiel Payment error: Unable to connect to eWAY. Please try again.

Die Zahlungsart funktioniert an der klassischen Kasse, am Kassen-Block und auf der Seite Pay for order. Sie ist mit der WooCommerce-Speicherung hochperformanter Bestellungen (HPOS) kompatibel.

eWAY sendet für die Shared Page keine Server-zu-Server-Benachrichtigungen: Das Ergebnis wird bei der Rückkehr des Kunden und bei den oben beschriebenen Prüfungen ermittelt. Das Plugin hat keine Kartenfelder auf Ihrer Website, keine gespeicherten Karten oder Abonnements, keine reine Autorisierung mit späterer Erfassung und wertet keine Betrugsbewertungen von Beagle aus (Transaktionen, die von den Betrugsregeln von eWAY blockiert werden, lehnt eWAY selbst ab).

Bestellungen und Erstattungen

Bestellstatus

Pending payment: der Kunde wurde zu eWAY weitergeleitet und hat noch nicht bezahlt, oder das Ergebnis konnte noch nicht von eWAY abgerufen werden (die Bestellnotiz weist darauf hin).

Processing or Completed: die Zahlung wurde genehmigt. Der Status richtet sich nach Order Status on Success. Die Bestellnotiz zeigt die eWAY-Transaktions-ID, den Autorisierungscode und die Antwort. Die Transaktions-ID der Bestellung ist die eWAY-Transaktions-ID.

On hold after payment: eWAY hat einen anderen Betrag oder eine andere Währung genehmigt als die Bestellung hat (zum Beispiel Approved for partial amount, oder die Bestellung wurde bearbeitet, nachdem der Kunde die Zahlungsseite geöffnet hatte), oder die Zahlung wurde genehmigt, nachdem die Bestellung storniert worden war. Die Notiz erklärt es. Auf der Seite „Bestellung eingegangen“ sieht der Kunde Your payment was received and is being reviewed by the store. We will contact you if anything is needed. Schließen Sie die Bestellung ab oder erstatten Sie die Zahlung.

Failed: eWAY hat die Zahlung abgelehnt. Die Notiz zeigt den eWAY-Code und seine Bedeutung.

Cancelled: der Kunde hat auf der eWAY-Seite storniert, nachdem die Bestellung an der Kasse aufgegeben wurde, oder die Bestellung wurde von Ihnen oder durch das Zeitlimit für die Lagerbestandsreservierung von WooCommerce storniert, nachdem eWAY bestätigt hatte, dass nicht bezahlt wurde.

Wird eine zweite Zahlung für eine bereits bezahlte Bestellung genehmigt, bleibt die Bestellung unverändert. Eine Notiz bittet Sie, das Duplikat in MyeWAY zu erstatten.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Credit Card (eWAY) (die Schaltfläche verwendet den Titel der Zahlungsart). Vollständige und teilweise Erstattungen werden unterstützt. Die Erstattung wird in der Umgebung gesendet, in der die Zahlung erfolgte (Sandbox oder Live), daher müssen Schlüssel und Passwort dieser Umgebung eingerichtet sein. Lehnt eWAY die Erstattung ab, zeigt WooCommerce den eWAY-Code an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird mit der eWAY-Erstattungs-Transaktions-ID in den Bestellnotizen ergänzt.

In MyeWAY vorgenommene Erstattungen werden nicht mit WooCommerce synchronisiert. Erstellen Sie bei Bedarf eine manuelle Erstattung in WooCommerce ohne die eWAY-Erstattungsschaltfläche.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > eWAY. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren 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 dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsart weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und Erstattungen funktionieren.

Läuft eine Lizenz ab, funktioniert das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

eWAY erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, Schlüssel und Passwort des aktuellen Modus gesetzt sind (Sandbox-Felder im Sandbox-Modus, Live-Felder im Live-Modus) und die Shopwährung AUD, NZD, SGD, HKD oder MYR ist. Auf der Seite Pay for order wird die Bestellwährung geprüft.

The payment went through, but the order stays Pending payment: Der Kunde ist nicht von eWAY zurückgekehrt, oder eWAY konnte in diesem Moment nicht abgefragt werden. eWAY sendet für die Shared Page keine Benachrichtigungen. Die Zahlung wird beim Aufrufen der Seite „Bestellung eingegangen“ und vor der automatischen Stornierung der unbezahlten Bestellung durch WooCommerce erneut geprüft. Prüfen Sie die Transaktion in MyeWAY und sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_eway_payment_gateway.

Der Kunde sieht die Meldung This payment method is temporarily unavailable: Schlüssel oder Passwort des aktuellen Modus fehlen, oder eWAY hat sie abgelehnt. Prüfen Sie die Zugangsdaten des aktuellen Modus.

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

Der Kunde sieht die Meldung We could not match this payment to an order: Der Rücksprung-Link gehört zu keiner Bestellung dieses Shops. Wurde der Kunde belastet, suchen Sie die Zahlung in MyeWAY.

Der Kunde sieht die Meldung We could not confirm your payment with eWAY: Das Ergebnis der Zahlung konnte nicht geprüft werden. Die Bestellung wird aktualisiert, sobald das Ergebnis abgerufen wird; der Kunde sollte nicht erneut bezahlen.

Order is On hold after payment: Lesen Sie die Bestellnotiz. Der genehmigte Betrag oder die Währung wich von der Bestellung ab, oder die Zahlung kam, nachdem die Bestellung storniert wurde. Schließen Sie die Bestellung ab oder erstatten Sie die Zahlung.

Erstattung schlägt mit einer Meldung zum Sandbox- oder Live-Modus fehl: Die Bestellung wurde in dieser Umgebung bezahlt, und deren Schlüssel und Passwort sind nicht gesetzt. Geben Sie sie ein und versuchen Sie es erneut.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Für Entwickler listet die readme-Datei den Filter eway_p_supported_currencies auf, falls Ihr eWAY-Konto für weitere Währungen freigeschaltet ist.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen und die Protokolle werden nur entfernt, wenn Uninstall (Delete all plugin data on uninstall) aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Auf Bestellungen gespeicherte Zahlungsreferenzen werden immer beibehalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

eWAY ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit eWAY verbunden noch wird es von eWAY unterstützt.