VibeFox EveryPay for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv.

PHP: 8.0 oder neuer.

EveryPay-Konto: Sie benötigen den API-Benutzernamen, das API-Secret und den Namen des Verarbeitungskontos Ihres Shops. Sie finden sie im EveryPay Merchant Portal in den Einstellungen Ihres Shops: das Demo-Portal (mwt-demo.every-pay.com) für den Testmodus und das Live-Portal (portal.every-pay.eu) für Live-Zahlungen. Test- und Live-Umgebung haben getrennte Zugangsdaten. Außerdem tragen Sie die Callback-URL Ihres Shops in beiden Portalen ein (siehe Konfiguration).

Shopwährung: Das Verarbeitungskonto legt die belastete Währung fest, zum Beispiel belastet EUR3D1 in EUR. Die Zahlungsart wird nur für Bestellungen in dieser Währung angeboten.

VibeFox-Lizenzschlüssel: Erhältlich 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 und klicken Sie auf Install Now. Sie können auch den Ordner wcp_everypay_payment per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

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

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

5. Geben Sie den API-Benutzernamen für Tests, das API-Secret für Tests und den Namen des Verarbeitungskontos aus dem Merchant Portal der Demo-Umgebung ein. Lassen Sie Test Mode eingeschaltet.

6. Kopieren Sie die auf der Einstellungsseite angezeigte Callback-URL in die Callback notification URL Ihres Shops im Merchant Portal.

7. Schalten Sie Enable/Disable ein und machen Sie eine Testbestellung. Wenn alles funktioniert, geben Sie die Live-Zugangsdaten ein, setzen Sie die Callback-URL auch im Live-Portal und entfernen Sie den Haken bei Test Mode.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > EveryPay. Oberhalb der Felder zeigt die Seite Test mode is on: payments go to the EveryPay demo environment, no real money is charged., solange der Testmodus aktiviert ist. Sie warnt, wenn das Gateway aktiviert ist, aber API-Benutzername, API-Secret oder Verarbeitungskonto des aktuellen Modus fehlen (die Zahlungsart wird dann an der Kasse ausgeblendet), und wenn das Verarbeitungskonto in einer anderen Währung als der Shopwährung belastet. In der Liste der Zahlungsarten ist EveryPay als einrichtungsbedürftig markiert, bis der aktuelle Modus konfiguriert ist. Leerzeichen und Zeilenumbrüche, die zusammen mit den Zugangsdaten eingefügt werden, werden beim Speichern entfernt.

Allgemein

Enable/Disable: Enable EveryPay payment gateway schaltet die Zahlungsart ein oder aus. Standard: aus.

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Standard: EveryPay.

Description: der Text unter der Zahlungsart an der Kasse. Standard: Pay securely by card or bank link on the EveryPay payment page.

EveryPay-Konto

API-Benutzername, API-Secret und Name des Verarbeitungskontos stehen im EveryPay Merchant Portal (Shop-Einstellungen): das Demo-Portal für den Testmodus, das Live-Portal für Live-Zahlungen.

Test Mode: Enable test mode sendet Zahlungen mit den Testzugangsdaten an die Demo-Umgebung von EveryPay. Es wird kein echtes Geld belastet. Standard: an.

Test API Username: der API-Benutzername der Demo-Umgebung.

Test API Secret: das API-Secret der Demo-Umgebung.

Live API Username: der API-Benutzername der Live-Umgebung.

Live API Secret: das API-Secret der Live-Umgebung.

Processing Account Name: das EveryPay-Verarbeitungskonto, zum Beispiel EUR3D1. Das Konto legt die belastete Währung fest: Das Gateway wird nur für Bestellungen in dieser Währung angeboten. In beiden Modi wird derselbe Kontoname verwendet.

Zahlungsbenachrichtigungen (Callback)

Der Callback teilt Ihrem Shop mit, dass eine Zahlung abgeschlossen wurde, sodass Bestellungen auch aktualisiert werden, wenn der Kunde den Browser schließt. Kopieren Sie die in diesem Abschnitt angezeigte URL in die Callback notification URL Ihres Shops im EveryPay Merchant Portal, sowohl für Demo als auch für Live. Die URL sieht so aus: https://your-site/wc-api/wc_evp_payment/. Die Zahlungsanfrage enthält keine Callback-URL, daher muss sie im Portal eingetragen werden.

Der Callback enthält nur Zahlungsreferenzen. Wenn er eingeht, fragt das Plugin die EveryPay-API nach dem Zahlungsstatus in der Umgebung ab, in der die Zahlung erstellt wurde, und prüft, ob die Antwort zu dieser Bestellung gehört. Callbacks für eine Zahlung, die die Bestellung nicht erstellt hat, werden abgelehnt. Ohne Callback wird eine Bestellung bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt, oder wenn Sie Check EveryPay payment status an der Bestellung ausführen.

Erweitert

Debug log: Log payment events schreibt Zahlungsereignisse nach WooCommerce > Status > Logs, Quelle wcp_everypay_payment. Fehler werden immer protokolliert. API-Secrets und Kartendaten werden nie protokolliert. Standard: aus.

Uninstall: Delete the gateway settings and logs when the plugin is deleted. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig EveryPay) und gibt die Bestellung auf. Im Testmodus zeigt die Kasse TEST MODE: EveryPay demo environment, no real money is charged. an. Das Plugin erstellt für den Bestellbetrag mit der E-Mail-Adresse und den Rechnungsdaten des Kunden eine einmalige EveryPay-Zahlung und leitet den Kunden zur EveryPay-Zahlungsseite weiter. Die Sprache der Seite richtet sich nach der Sprache der Website (Englisch, Estnisch, Russisch, Lettisch, Litauisch, Finnisch oder Deutsch; sonst Englisch). Dort zahlt der Kunde mit einer der Methoden, die für Ihr EveryPay-Konto aktiviert sind.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn EveryPay sie bestätigt: Das Plugin fragt bei der Rückkehr und beim Callback die EveryPay-API nach dem Status der Zahlung ab. Eine bezahlte Bestellung, eine Bestellung in Prüfung oder eine Zahlung, die noch verarbeitet wird, führt zur Seite „Bestellung eingegangen“.

Schlägt die Zahlung fehl, kehrt der Kunde zur Kasse (oder zur Seite Pay for order) zurück, mit der Meldung Your EveryPay payment was not successful. Please try again or choose another payment method. Hat der Kunde die Zahlungsseite verlassen, ohne zu zahlen, lautet die Meldung The EveryPay payment was not completed. You can try again or choose another payment method. Jeder neue Versuch erstellt eine neue EveryPay-Zahlung. Ältere Versuche werden berücksichtigt, sodass eine Zahlung über einen älteren Link trotzdem erkannt wird.

Kann EveryPay die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. Die Details stehen im Protokoll.

Die Zahlungsart funktioniert an der klassischen Kasse, am Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel. Die kundenseitigen Texte sind ins Estnische übersetzt.

Das Plugin unterstützt nur einmalige Zahlungen. Es bietet keine Erstattungen oder Erfassungen aus WooCommerce, keine gespeicherten Karten oder Ein-Klick-Zahlungen, keine Abonnements oder wiederkehrenden Zahlungen, keine eingebetteten Kartenfelder und keine Mehrwährungsunterstützung.

Bestellungen

Bestellstatus

Pending payment: Der Kunde wurde zu EveryPay weitergeleitet und hat noch nicht bezahlt, oder die Zahlung wird noch verarbeitet.

Processing: EveryPay hat die Zahlung als abgerechnet oder autorisiert gemeldet (Bestellungen, die nur virtuelle herunterladbare Produkte enthalten, werden auf „Abgeschlossen“ gesetzt, der WooCommerce-Standard). Die Bestellnotiz zeigt Betrag, Währung und Zahlungsreferenz. Die Transaktions-ID der Bestellung ist die Zahlungsreferenz von EveryPay. Bei einer autorisierten Zahlung weist die Notiz darauf hin, dass die Mittel reserviert sind: Wenn Ihr Konto nicht automatisch erfasst, erfassen Sie die Zahlung im EveryPay Merchant Portal. Wird sie später abgerechnet, weist eine Notiz darauf hin.

On hold after payment: Die Zahlung muss manuell geprüft werden. Der gezahlte Betrag oder die Währung weicht von der Bestellung ab, die Bestellung war storniert, bevor die Zahlung eintraf, oder die Bestellung verwendet jetzt eine andere Zahlungsart. Die Notiz erklärt dies und weist darauf hin, dass die Bestellung nicht als bezahlt markiert wurde. Prüfen Sie die Zahlung im Merchant Portal und schließen Sie sie manuell ab oder erstatten Sie sie. Spätere Callbacks zu dieser Zahlung schließen die Bestellung nicht automatisch ab.

Failed: Der letzte Zahlungsversuch einer unbezahlten Bestellung ist fehlgeschlagen, wurde abgebrochen oder storniert. Die Notiz zeigt den Grund von EveryPay. Der Kunde kann es erneut versuchen.

Wird eine zweite Zahlung für eine bereits bezahlte Bestellung abgeschlossen, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung im EveryPay Merchant Portal zu erstatten.

Check EveryPay payment status

Wählen Sie auf der Bestellseite die Bestellaktion Check EveryPay payment status. Das Plugin prüft jede EveryPay-Zahlung der Bestellung über die API, wendet das Ergebnis wie oben beschrieben an und fügt eine Notiz mit dem Status jeder Zahlung hinzu. Verwenden Sie die Aktion für Bestellungen, deren Callback nie eingegangen ist.

Erstattungen

Erstattungen aus WooCommerce werden nicht unterstützt. Erstatten Sie im EveryPay Merchant Portal und setzen Sie dann den Bestellstatus in WooCommerce. Meldet EveryPay eine Zahlung als erstattet oder als Chargeback, fügt das Plugin nur eine Bestellnotiz hinzu; der Bestellstatus ändert sich nicht.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > EveryPay. 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 EveryPay Kunden an der Kasse nicht angezeigt. Wird trotzdem 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 einrichten und testen können, bevor Sie einen Schlüssel kaufen. Eine Erinnerung erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, und die Statusprüfung funktioniert.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, Updates und Support erfordern aber eine Verlängerung. Der Status wird im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

EveryPay erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, API-Benutzername, API-Secret und Processing Account Name des aktuellen Modus gesetzt sind und die Shopwährung (auf der Seite Pay for order die Bestellwährung) der Währung des Verarbeitungskontos entspricht. Die Einstellungsseite zeigt in diesen Fällen eine Warnung an.

Die Zahlung war erfolgreich, aber die Bestellung bleibt bei Pending payment: Der Callback funktioniert nicht. Prüfen Sie, ob die Callback-URL aus den Einstellungen als Callback notification URL im Merchant Portal des von Ihnen verwendeten Modus (Demo oder Live) eingetragen ist. Sie können auch die Bestellung öffnen und Check EveryPay payment status ausführen. Aktivieren Sie Debug log und sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_everypay_payment.

Callback antwortet Unknown payment reference oder Payment does not belong to this order: Die Zahlung wurde nicht von dieser Bestellung erstellt, oder die Antwort von EveryPay passt nicht dazu. Die Bestellung wird nicht geändert.

Callback antwortet Not configured: Die Zugangsdaten der Umgebung, in der die Zahlung erstellt wurde, fehlen, zum Beispiel bei einer Testzahlung, nachdem die Testzugangsdaten entfernt wurden. Geben Sie sie erneut ein; EveryPay wiederholt den Callback.

Callback antwortet Payment status unavailable oder Busy, please retry: Die EveryPay-API war nicht erreichbar oder die Bestellung wurde gerade durch eine andere Anfrage aktualisiert. EveryPay wiederholt den Callback.

Der Kunde sieht EveryPay is temporarily unavailable: EveryPay hat die Zugangsdaten abgelehnt oder war nicht erreichbar. Prüfen Sie API-Benutzername und API-Secret des aktuellen Modus.

Der Kunde sieht This payment method does not support the order currency: Die Bestellwährung weicht von der Währung des Verarbeitungskontos ab.

Bestellung ist On hold after payment: Lesen Sie die Bestellnotiz. Betrag oder Währung waren abweichend, oder die Bestellung war storniert, bevor die Zahlung eintraf. Prüfen Sie die Zahlung im Merchant Portal und schließen Sie sie manuell ab oder erstatten Sie sie.

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 Plugin-Dokumentation die Filter wc_evp_icon, wc_evp_locale, wc_evp_currency_decimals und wc_evp_oneoff_request auf.

Deinstallation

Beim Deaktivieren des Plugins bleiben alle Daten erhalten. 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 the gateway settings and logs when the plugin is deleted) aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. EveryPay-Zahlungsreferenzen, die in Bestellungen gespeichert sind, bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

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