VibeFox GoPay for WooCommerce — Hilfe
Anforderungen
WordPress: 6.0 oder neuer.
WooCommerce: 7.6 oder neuer, installiert und aktiviert. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.
PHP: 8.0 oder neuer.
Währung: GoPay akzeptiert CZK, EUR, PLN, USD, GBP, HUF, RON und BGN. Bei einer anderen Währung wird die Zahlungsmethode an der Kasse ausgeblendet.
GoPay-Konto: Sie benötigen die GoID, die Client ID und das Client Secret Ihres GoPay-Händlerkontos. Sie finden diese Angaben in den Integrationseinstellungen des Kontos. Das Sandbox-Testkonto hat eigene Zugangsdaten. Für Benachrichtigungen muss im GoPay-Konto nichts eingerichtet werden, aber Ihr Shop muss aus dem Internet erreichbar sein.
VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt für eine 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 den Ordner wcp_gopay_gateway auch per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > GoPay > Manage, oder klicken Sie auf der Plugins-Seite unter dem Plugin-Namen auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzbereich oben auf der Seite ein und klicken Sie auf Activate.
5. Geben Sie die GoID, die Client ID und das Client Secret der Sandbox ein, lassen Sie Test Mode aktiviert und schalten Sie Enable/Disable ein.
6. Geben Sie eine Testbestellung auf. Wenn alles funktioniert, geben Sie die Zugangsdaten für den Produktivbetrieb ein und deaktivieren Sie Test Mode.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > GoPay. Unter der Beschreibung des Gateways zeigt die Seite Sandbox mode — test payments only oder Production mode — real payments an. Sie erhalten einen Hinweis, wenn die GoID, die Client ID oder das Client Secret des aktuellen Modus fehlt oder GoPay die Shopwährung nicht akzeptiert. In beiden Fällen wird GoPay an der Kasse nicht angeboten. In der Liste der Zahlungsmethoden ist das Gateway als noch einzurichten markiert, bis die Zugangsdaten für den aktuellen Modus hinterlegt sind. Beim Speichern werden die zwischengespeicherten GoPay-Zugriffstokens gelöscht, damit neue Zugangsdaten sofort verwendet werden.
Enable/Disable: Enable GoPay payment gateway schaltet die Zahlungsmethode ein oder aus. Standard: aus.
Title: Titel der Zahlungsmethode, der an der Kasse angezeigt wird. Standard: GoPay.
Description: Beschreibung der Zahlungsmethode, die an der Kasse angezeigt wird. Standard: Pay securely via GoPay - cards, wallets, bank transfers.
API-Zugangsdaten
GoID, Client ID und Client Secret werden in Ihrem GoPay-Händlerkonto (Integrationseinstellungen) angezeigt. Das Sandbox-Testkonto hat eigene Zugangsdaten. Die API-Dokumentation finden Sie auf doc.gopay.com.
Test Mode: Enable sandbox/test mode leitet Zahlungen mit den Sandbox-Zugangsdaten an gw.sandbox.gopay.com weiter. Es wird kein echtes Geld belastet. Deaktivieren Sie die Option, um mit den Zugangsdaten für den Produktivbetrieb echte Zahlungen anzunehmen (gate.gopay.cz). Standard: ein.
Sandbox GoID: die GoID Ihres GoPay-Sandbox-Testkontos.
Sandbox Client ID: die OAuth Client ID des Sandbox-Kontos.
Sandbox Client Secret: das OAuth Client Secret des Sandbox-Kontos.
Production GoID: Ihre GoPay-Händler-ID (GoID).
Production Client ID: die OAuth Client ID von GoPay.
Production Client Secret: das OAuth Client Secret von GoPay.
Eine GoID enthält nur Ziffern, zum Beispiel 8123456789. Wenn Sie etwas anderes eingeben, zeigt die Seite einen Fehler an und der vorherige Wert bleibt erhalten.
Zahlung
Payment Page Language: Sprache der GoPay-Zahlungsseite. Standard: Automatic (site language, then billing country). Die automatische Auswahl verwendet die Sprache Ihrer Website. Falls GoPay diese Sprache nicht anbietet, ist das Rechnungsland ausschlaggebend; andernfalls wird Englisch verwendet. Sie können auch eine von 19 Sprachen festlegen: Tschechisch, Englisch, Slowakisch, Deutsch, Polnisch, Ungarisch, Rumänisch, Bulgarisch, Kroatisch, Slowenisch, Estnisch, Lettisch, Litauisch, Französisch, Italienisch, Spanisch, Portugiesisch, Ukrainisch oder Russisch.
Order Status After Payment: Bestellstatus, der nach Bestätigung der Zahlung gesetzt wird. Er wird sofort gesetzt, mit nur einer Statusänderung und einer Kunden-E-Mail.
Zahlungsbenachrichtigungen
Die Benachrichtigung teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Die Benachrichtigungs-URL wird mit jeder Zahlung an GoPay gesendet; im GoPay-Konto muss daher nichts eingerichtet werden. Die Einstellungen zeigen die URL an. Sie sieht etwa so aus: https://your-site/?gopay-api=gopay_payment_notification. Sie muss aus dem Internet erreichbar sein und darf nicht durch Passwortschutz, Wartungsmodus oder eine vorgeschaltete Firewall blockiert werden.
GoPay-Benachrichtigungen enthalten nur die Zahlungs-ID und keine Signatur. Jede Benachrichtigung wird geprüft, indem die API von GoPay nach dem Zahlungsstatus gefragt wird. Außerdem muss das Plugin die Zahlung für eine Bestellung Ihres Shops erstellt haben. Kann der Status nicht bei GoPay abgerufen werden, antwortet Ihr Shop mit einem Fehler, und GoPay sendet die Benachrichtigung erneut. Ohne Benachrichtigungen wird eine Bestellung erst bestätigt, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.
Erweitert
Logging: Enable logging schreibt GoPay-Ereignisse in WooCommerce > Status > Logs, Quelle wcp_gopay_gateway. Fehler werden immer protokolliert. Zugangsdaten, Tokens, Kartendaten sowie E-Mail-Adresse, Telefonnummer und Anschrift des Kunden werden nie protokolliert. Standard: aus.
Delete Data on Uninstall: Delete plugin settings, cached access tokens and log files when uninstalled. Wenn die Option aktiviert ist, werden beim Löschen des Plugins die Gateway-Einstellungen, zwischengespeicherte GoPay-Zugriffstokens und Protokolle entfernt. Standard: aus.
Kasse
Der Kunde wählt die Zahlungsmethode (standardmäßig GoPay) und gibt die Bestellung auf. Das Plugin erstellt eine GoPay-Zahlung über den Bestellgesamtbetrag in der Bestellwährung einschließlich Bestellpositionen, Versand und Gebühren und leitet den Kunden zur GoPay-Zahlungsseite weiter. Dort bietet GoPay die in Ihrem GoPay-Konto aktivierten Zahlungsmethoden an, etwa Zahlungskarten, Apple Pay, Google Pay und Banküberweisungen. Name, E-Mail-Adresse, Telefonnummer und Anschrift des Kunden aus der Rechnungsadresse werden an GoPay übermittelt; leere Felder werden ausgelassen. Bei GoPay wird die Zahlung als Order gefolgt von der Bestellnummer angezeigt.
Nach der Zahlung kehrt der Kunde zu Ihrem Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn GoPay dies bestätigt: durch die Benachrichtigung oder durch eine Anfrage an die GoPay-API bei der Rückkehr des Kunden. Treffen eine Benachrichtigung und die Rückkehr gleichzeitig ein, werden sie nacheinander verarbeitet, sodass die Bestellung nie zweimal abgeschlossen wird. Nach Bestätigung der Zahlung gelangt der Kunde auf die Seite für den Bestelleingang.
Wurde die Zahlung nicht abgeschlossen, storniert oder ist sie abgelaufen, wird der Kunde zur Seite Pay for order weitergeleitet und sieht die Meldung The GoPay payment was not completed. You can try again or choose another payment method. oder The GoPay payment was cancelled or has expired. You can try again or choose another payment method. Auf dieser Seite kann der Kunde eine unbezahlte Bestellung erneut bezahlen. Für eine bereits bezahlte Bestellung wird keine zweite GoPay-Zahlung erstellt.
Kann GoPay die Zahlung nicht starten, sieht der Kunde eine kurze Meldung, zum Beispiel GoPay could not accept the payment details. Please check your billing details (e-mail, phone, address) or choose another payment method. oder GoPay is temporarily unavailable. Please try again in a moment or choose another payment method. Der technische Grund wird den Bestellnotizen hinzugefügt.
Die Zahlungsmethode funktioniert an der klassischen Kasse, in den Cart- und Checkout-Blöcken und auf der Seite Pay for order. Im Sandbox-Modus zeigt der Checkout-Block Sandbox mode: no real payment will be made. an. Die Methode ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Der Kunde wählt die Zahlungsmethode auf der GoPay-Seite; sie kann nicht in WooCommerce ausgewählt werden. Das Plugin unterstützt keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, kein eingebettetes Zahlungsformular und kein Erfassen oder Aufheben von Vorautorisierungen in WooCommerce.
Bestellungen und Erstattungen
Bestellstatus
Pending payment: Der Kunde wurde zu GoPay weitergeleitet und hat noch nicht bezahlt, oder GoPay hat die Zahlung noch nicht bestätigt.
Processing or Completed: Die Zahlung wurde bestätigt. Der Status richtet sich nach Order Status After Payment. Die Bestellnotiz enthält die GoPay-Zahlungs-ID und das Zahlungsmittel. Die Transaktions-ID entspricht der GoPay-Zahlungs-ID.
On hold: GoPay hat die Zahlung bestätigt, aber Betrag oder Währung stimmen nicht mit der Bestellung überein; oder die Zahlung ging ein, nachdem die Bestellung storniert worden war; oder die Zahlung ist nur vorautorisiert und das Geld wurde noch nicht eingezogen. Die Bestellnotiz erläutert den Grund. Eine vorautorisierte Zahlung muss in GoPay eingezogen werden; anschließend müssen Sie die Bestellung manuell abschließen.
Failed: Die letzte GoPay-Zahlung einer unbezahlten Bestellung wurde storniert oder ist abgelaufen.
Refunded: Die GoPay-Zahlung der Bestellung wurde vollständig erstattet, zum Beispiel im GoPay-Konto.
Wird auch ein weiterer Zahlungsversuch für eine bereits bezahlte Bestellung bezahlt, bleibt die Bestellung unverändert. Eine Notiz fordert Sie auf, die doppelte Zahlung im GoPay-Konto zu erstatten. Eine ähnliche Notiz wird hinzugefügt, wenn eine GoPay-Zahlung für eine Bestellung eingeht, die bereits ohne GoPay als bezahlt markiert wurde, zum Beispiel manuell. Eine bezahlte Bestellung, die Sie storniert oder erstattet haben, wird durch eine spätere Benachrichtigung nie wieder geöffnet.
Erstattungen
Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via GoPay. Vollständige und teilweise Erstattungen werden unterstützt. Teilweise Erstattungen akzeptiert GoPay erst 24 Stunden nach der Zahlung. Die Erstattung wird in dem Modus ausgeführt, in dem die Zahlung erfolgte (Sandbox oder Produktivbetrieb); daher müssen die Zugangsdaten dieses Modus hinterlegt sein. Lehnt GoPay die Erstattung ab, zeigt WooCommerce die Meldung von GoPay an und es wird keine Erstattung erfasst. Eine erfolgreiche Erstattung wird den Bestellnotizen hinzugefügt. Auch eine von GoPay zur späteren Bearbeitung akzeptierte Erstattung wird als angenommen vermerkt.
Im GoPay-Konto vorgenommene Erstattungen gehen per Benachrichtigung ein. Eine vollständige Erstattung setzt den Bestellstatus auf „Erstattet“; bei einer teilweisen Erstattung wird eine Notiz hinzugefügt. Sie werden nicht automatisch als WooCommerce-Erstattungen erfasst.
Lizenzschlüssel
Das Plugin benötigt einen VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben auf WooCommerce > Settings > Payments > GoPay. Fügen Sie den Schlüssel unter License key ein und klicken Sie auf Activate. Der Bereich zeigt den Status an, zum Beispiel das Ablaufdatum der Lizenz 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 Konto auf vibefox.net.
Ein Schlüssel gilt für eine Domain. Wenn Sie den Schlüssel von einer Website entfernen, wird der Domainplatz nicht freigegeben. Geben Sie den Platz in Ihrem Konto auf vibefox.net frei.
Ohne aktiven Schlüssel wird GoPay den 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 Zahlungsmethode weiterhin, gekennzeichnet mit (unlicensed — visible to admins only). So können Sie das Plugin einrichten und testen, bevor Sie einen Schlüssel kaufen. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt und Erstattungen funktionieren.
Nach Ablauf einer Lizenz funktioniert das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung erforderlich. Der Status wird automatisch im Hintergrund erneut geprüft.
Problembehandlung
GoPay wird an der Kasse nicht angezeigt: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, für den aktuellen Modus GoID, Client ID und Client Secret hinterlegt sind und die Währung CZK, EUR, PLN, USD, GBP, HUF, RON oder BGN lautet. Auf der Seite Pay for order ist die Bestellwährung ausschlaggebend. Auf der Einstellungsseite erscheint ein Hinweis, wenn Zugangsdaten oder Währung ungültig sind.
Die Zahlung wurde ausgeführt, aber der Bestellstatus bleibt Pending payment: GoPay konnte die in den Einstellungen angezeigte Benachrichtigungs-URL nicht erreichen und der Kunde kehrte nicht zum Shop zurück. Entfernen Sie Passwortschutz, Wartungsmodus oder Firewall-Regeln, die die URL blockieren. Prüfen Sie, ob die Zugangsdaten des Modus hinterlegt sind, in dem die Zahlung erfolgte, da jede Benachrichtigung damit geprüft wird. Sehen Sie unter WooCommerce > Status > Logs nach, Quelle wcp_gopay_gateway. GoPay sendet Benachrichtigungen erneut, wenn keine erfolgreiche Antwort eingeht.
Die Benachrichtigung antwortet mit „Order not found“: Die Zahlung wurde nicht von diesem Shop erstellt oder die zugehörige Bestellung wurde gelöscht.
Die Benachrichtigung antwortet mit „Payment state could not be verified“: Die GoPay-API war nicht erreichbar oder die Zugangsdaten für diesen Modus sind falsch. GoPay sendet die Benachrichtigung erneut.
Beim Aufgeben der Bestellung sieht der Kunde eine Fehlermeldung: Öffnen Sie die Bestellnotizen oder schalten Sie Logging ein. Die Notiz enthält den GoPay-Fehler. Meist sind falsche Zugangsdaten oder Zugangsdaten für den anderen Modus die Ursache. Eine Meldung zu den Rechnungsdaten bedeutet, dass GoPay die E-Mail-Adresse, Telefonnummer oder Anschrift nicht akzeptiert hat.
Testzahlungen bestätigen keine echte Bestellung: Sandbox und Produktivbetrieb sind getrennt. Jede Zahlung wird in dem Modus geprüft, in dem sie erstellt wurde. Stellen Sie Test Mode auf den gewünschten Modus ein und verwenden Sie die zugehörigen Zugangsdaten.
Bestellung ist nach der Zahlung On hold: Lesen Sie die Bestellnotiz. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, die Zahlung ging nach der Stornierung der Bestellung ein oder die Zahlung ist nur vorautorisiert.
Erstattung schlägt fehl: Lesen Sie die Meldung von GoPay. Eine teilweise Erstattung ist erst 24 Stunden nach der Zahlung möglich. Eine Meldung zum Modus bedeutet, dass die Zahlung im Sandbox- oder Produktivmodus erfolgte und die Zugangsdaten dieses Modus fehlen.
Im Lizenzbereich wird ein Fehler angezeigt: Folgen Sie der Meldung im Bereich. Wenn der Schlüssel zum Beispiel bereits für eine andere Domain verwendet wird, geben Sie einen Platz in Ihrem Konto auf vibefox.net frei und klicken Sie auf Check now. Wenn sich die Website-Adresse geändert hat, 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: Der Filter gopay_p_payment_payload ändert die Zahlungsanfrage und gopay_p_icon ändert das Symbol der Zahlungsmethode.
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. Gateway-Einstellungen, zwischengespeicherte Zugriffstokens und Protokolle werden nur entfernt, wenn Delete Data on Uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte GoPay-Zahlungs-IDs bleiben immer erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.
GoPay ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit GoPay verbunden und wird von GoPay nicht unterstützt.