VibeFox GoPay 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.

Währung: GoPay akzeptiert CZK, EUR, PLN, USD, GBP, HUF, RON und BGN. Bei einer anderen Währung an der Kasse wird die Zahlungsart ausgeblendet.

GoPay-Konto: Sie benötigen die GoID, Client ID und Client Secret Ihres GoPay-Händlerkontos. Sie finden sie in den Integrationseinstellungen des Kontos. Das Sandbox-Testkonto hat eigene Zugangsdaten. Für Benachrichtigungen muss im GoPay-Konto nichts eingerichtet werden, Ihr Shop muss aber aus dem Internet erreichbar sein.

VibeFox-Lizenzschlüssel: Erwerb über vibefox.net. Ein Schlüssel funktioniert für eine Domain.

Installation

Der Download ist eine einzige 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_gopay_gateway-oc3-(version).ocmod.zip und das Paket für OpenCart 4 wcp_gopay_gateway.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_gopay_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 GoPay 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 License key).

4. Geben Sie Sandbox-GoID, Client ID und Client Secret ein, lassen Sie Test Mode eingeschaltet, schalten Sie Enable/Disable ein und klicken Sie auf Save.

5. Führen Sie eine Testbestellung durch. Wenn alles funktioniert, tragen Sie die Produktionszugangsdaten ein und schalten Sie Test Mode aus.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_gopay_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 GoPay Gateway, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die GoPay-Zugangsdaten wie in den Schritten 3 bis 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungs-URL unterscheidet sich (siehe Zahlungsbenachrichtigungen).

Eine neue Installation startet mit deaktivierter Zahlungsart und eingeschaltetem Testmodus.

Konfiguration

Alle Einstellungen befinden sich auf der Erweiterungsseite: Extensions > Extensions > Payments > VibeFox GoPay Gateway > Edit. Die Abschnitte sind links aufgeführt; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Oberhalb der Einstellungen zeigt die Seite Sandbox mode — test payments only oder Production mode — real payments. Sie warnt, wenn GoID, Client ID oder Client Secret des aktuellen Modus fehlen und wenn GoPay die Standardwährung des Shops nicht akzeptiert. Ohne Zugangsdaten wird GoPay an der Kasse nicht angeboten; bei einer nicht unterstützten Standardwährung wird es nur Kunden angeboten, die auf eine unterstützte Währung wechseln. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern behält ein Feld mit einem ungültigen Wert seinen bisherigen Wert, und die Seite zeigt einen Fehler; die übrigen Felder werden gespeichert. Das betrifft einen Title, der leer oder länger als 128 Zeichen ist, eine GoID, die nicht aus 6 bis 20 Ziffern besteht, eine Sort Order, die keine ganze Zahl ist, einen Total, der keine Zahl von 0 oder mehr ist, sowie eine Geo Zone oder einen Bestellstatus, der nicht existiert. Beim Speichern werden außerdem die zwischengespeicherten GoPay-Zugriffstoken gelöscht, damit die neuen Zugangsdaten sofort verwendet werden.

GoPay

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

Title: die Bezeichnung der Zahlungsart, die an der Kasse angezeigt wird. Sie wird auch als Name der Zahlungsart in der Bestellung gespeichert. Standard: GoPay. Pflichtfeld, bis zu 128 Zeichen.

Description: die Beschreibung der Zahlungsart auf dem Schritt Confirm Order, oberhalb der Bestätigungsschaltfläche. Standard: Pay securely via GoPay - cards, wallets, bank transfers.

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

Geo Zone: Bietet GoPay nur für Rechnungsadressen in der gewählten Geo Zone an. Standard: All zones. Geo Zones richten Sie unter System > Localisation > Geo Zones ein.

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

API-Zugangsdaten

GoID, Client ID und Client Secret werden in Ihrem GoPay-Händlerkonto angezeigt (Integrationseinstellungen). Das Sandbox-Testkonto hat eigene Zugangsdaten. Der Abschnitt verlinkt auf die GoPay-API-Dokumentation.

Test Mode: sendet Zahlungen an gw.sandbox.gopay.com mit den Sandbox-Zugangsdaten. Es wird kein echtes Geld belastet. Schalten Sie ihn aus, um echte Zahlungen mit den Produktionszugangsdaten anzunehmen. Standard: an.

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 besteht nur aus 6 bis 20 Ziffern, zum Beispiel 8123456789. Geben Sie etwas anderes ein, zeigt die Seite GoID must contain digits only, 6 to 20 digits (for example 8123456789). The previous value was kept.

Gespeicherte Client Secrets 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.

Clear saved client secrets: Setzen Sie den Haken und klicken Sie auf Save, um beide gespeicherten Client Secrets zu entfernen. Ein leeres Feld behält den gespeicherten Wert.

Zahlung

Payment Page Language: die Sprache der GoPay-Zahlungsseite. Standard: Automatic (site language, then billing country). Automatisch wird die Sprache Ihres Storefronts verwendet; bietet GoPay sie nicht an, entscheidet das Rechnungsland, und andernfalls wird Englisch verwendet. Sie können auch eine von 19 Sprachen festlegen: Czech, English, Slovak, German, Polish, Hungarian, Romanian, Bulgarian, Croatian, Slovenian, Estonian, Latvian, Lithuanian, French, Italian, Spanish, Portuguese, Ukrainian oder Russian.

OpenCart legt die Bestellung auf dem Schritt Confirm Order ohne Status an (fehlende Bestellung, missing order). Die Bestellung erhält erst einen Status, nachdem GoPay die Zahlung bestätigt hat, durch die Benachrichtigung oder die Rückkehr des Kunden; der Zustand wird immer über die GoPay-API abgefragt. Jedes Statusfeld unten listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: der Bestellstatus, der gesetzt wird, wenn die Zahlung bestätigt ist. Standard: In Bearbeitung. Wählen Sie zum Beispiel Abgeschlossen für virtuelle Produkte.

GoPay Payment On Hold Status: Zahlungen, die nicht zur Bestellung passen, Zahlungen nach einer Stornierung und nur vorautorisierte Zahlungen. Eine Notiz erklärt den Grund; prüfen Sie die Zahlung in Ihrem GoPay-Konto. Standard: Ausstehend, weil OpenCart keinen Status „On hold“ hat. Sie können unter System > Localisation > Order Statuses einen eigenen Status anlegen und hier auswählen.

Cancelled Order Status: Eine GoPay-Zahlung, die für eine Bestellung in diesem Status (oder im Status „Erstattet“) eingeht, setzt die Bestellung auf Halt, statt sie stillschweigend wieder zu öffnen. Standard: Storniert.

Refunded Status: wird gesetzt, nachdem die Zahlung vollständig erstattet wurde, von der Bestellseite aus oder wenn GoPay es meldet. Standard: Erstattet.

Zahlungsbenachrichtigungen

Die Benachrichtigung teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist. Die Notification URL wird in diesem Abschnitt angezeigt und bei jeder Zahlung an GoPay übermittelt, daher muss im GoPay-Konto nichts eingerichtet werden. Unter OpenCart 3 sieht sie etwa so aus: https://your-store/index.php?route=extension/payment/wcp_gopay_gateway/notify, unter OpenCart 4 so: https://your-store/index.php?route=extension/wcp_gopay_gateway/payment/wcp_gopay_gateway.notify. Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet. Sie muss aus dem Internet erreichbar sein: kein Passwortschutz und keine Firewall davor. Sie funktioniert auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und unter OpenCart 4 fügt die Erweiterung eine Startup-Aktion hinzu, die die Benachrichtigung und die Rückkehr des Kunden von GoPay durchlässt.

GoPay-Benachrichtigungen enthalten nur die Zahlungs-ID und keine Signatur. Jede Benachrichtigung wird geprüft, indem der Zahlungsstatus bei der GoPay-API abgefragt wird, mit den Zugangsdaten des Modus, in dem die Zahlung erfolgte; die Zahlung muss eine Zahlung sein, die die Erweiterung für eine Bestellung Ihres Shops erstellt hat. Kann der Status nicht bei GoPay abgerufen werden, antwortet Ihr Shop mit einem Fehler, und GoPay wiederholt die Benachrichtigung. Ohne Benachrichtigungen erhält eine Bestellung ihren Status nur, wenn der Kunde nach der Zahlung in den Shop zurückkehrt.

Erweitert

Logging: schreibt GoPay-Ereignisse in gopay_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Webbrowser öffnen. Fehler und Warnungen werden immer protokolliert. Zugangsdaten, Token, Kartendaten sowie die E-Mail-Adresse und der Name des Kunden werden nie 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 Data on Uninstall: ist die Option eingeschaltet, entfernt das Deinstallieren der Erweiterung die Gateway-Einstellungen, die zwischengespeicherten GoPay-Zugriffstoken und das Protokoll. Bestellungen und deren GoPay-Zahlungsdaten bleiben immer erhalten. Standard: aus.

Import / Export

Export: Download JSON speichert die Einstellungen als JSON-Datei. Die Client Secrets werden nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen. Die gespeicherten Client Secrets bleiben erhalten.

Kasse

Auf dem Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig GoPay). Auf dem Schritt Confirm Order sieht der Kunde Ihre Beschreibung. OpenCart legt die Bestellung in diesem Schritt an, weiterhin ohne Status. Klickt der Kunde auf Confirm Order, erstellt die Erweiterung eine GoPay-Zahlung über den Bestellbetrag in der Bestellwährung, mit den Produkten, Geschenkgutscheinen, dem Versand und den übrigen Bestellsummen, und leitet den Kunden auf die Zahlungsseite von GoPay weiter. Dort bietet GoPay die in Ihrem GoPay-Konto aktivierten Zahlungsarten an, zum Beispiel Zahlungskarten, Banküberweisungen und Wallets. Name, E-Mail-Adresse, Telefonnummer und Rechnungsadresse des Kunden werden an GoPay übergeben; leere Felder werden nicht gesendet. Die Zahlung erscheint bei GoPay mit der Bestellnummer OC- und der OpenCart-Bestellnummer.

Unter 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. OpenCart 4 kennt keine Geschenkgutscheine, daher werden an GoPay keine übermittelt. Standardmäßig fragt OpenCart 4 nicht nach einer Rechnungsadresse; dann übergibt die Erweiterung Name und Adresse der Lieferadresse an GoPay.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn GoPay sie bestätigt: durch die Benachrichtigung oder durch eine Anfrage an die GoPay-API, wenn der Kunde zurückkehrt. Benachrichtigung und Rückkehr, die im selben Moment eintreffen, werden nacheinander verarbeitet, sodass die Zahlung nur einmal übernommen wird. Die Bestellung erhält dann ihren Status auf die übliche OpenCart-Weise, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung. Wurde die Bestellung in den Status „Halt“ versetzt, ergänzt die Seite den Hinweis Your payment is being reviewed. We will contact you if anything else is needed.

Hat GoPay die Zahlung bei der Rückkehr des Kunden noch nicht bestätigt (zum Beispiel weil eine Banküberweisung unterwegs ist oder GoPay nicht erreichbar ist), zeigt eine Seite Payment confirmation den Text GoPay has not confirmed your payment yet. Your order will be confirmed automatically as soon as the payment is confirmed — please do not pay again. mit den Schaltflächen Check again und Back to checkout.

Wurde die Zahlung nicht abgeschlossen, abgebrochen oder ist sie abgelaufen, kehrt der Kunde mit 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. zur Kasse zurück. Der Warenkorb bleibt erhalten. Auf OpenCart 4 werden diese Meldungen oberhalb der Kassenseite angezeigt. Jeder neue Versuch (unter OpenCart 3 legt OpenCart jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an; unter OpenCart 4 aktualisiert OpenCart die Bestellung der Kasse und bezahlt sie mit einer neuen GoPay-Zahlung unter derselben Bestellnummer) prüft zuerst die offenen GoPay-Zahlungen des Warenkorbs über die GoPay-API. Ist eine davon bereits bezahlt, wird diese Zahlung bestätigt, und der Kunde gelangt zur Erfolgsseite, ohne erneut zu zahlen. Eine Änderung des Warenkorbs, auch eine neue Menge, gilt als neuer Warenkorb, der eine eigene Zahlung braucht.

OpenCart 4 hält die Bestellung in der Kasse, bis die Erfolgsseite angezeigt wird. Wurde diese Bestellung inzwischen ohne Zahlung geschlossen (zum Beispiel haben Sie sie storniert oder erstattet), kehrt der Kunde zur Kasse zurück, mit Your previous order was cancelled or refunded. Please confirm the order again. (oder der Meldung zur stornierten Zahlung), und das nächste Confirm Order bezahlt eine neue Bestellung. Eine bezahlte Bestellung wird nie als bezahlt für einen anderen Warenkorb angezeigt.

Kann GoPay die Zahlung nicht starten, bleibt der Kunde auf dem Schritt Confirm Order mit einer kurzen Meldung über der Schaltfläche, 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 im Protokoll festgehalten.

Der Kunde wählt die Zahlungsart auf der GoPay-Seite; in OpenCart kann sie nicht gewählt werden. Die Erweiterung unterstützt keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, kein eingebettetes Zahlungsformular und keine Erfassung oder Stornierung von Vorautorisierungen aus OpenCart heraus.

Bestellungen und Erstattungen

Bestellstatus

No status (missing order): Der Kunde wurde zu GoPay weitergeleitet und hat nicht bezahlt, oder GoPay hat die Zahlung noch nicht bestätigt. Eine abgebrochene oder abgelaufene GoPay-Zahlung lässt die Bestellung ohne Status zurück, mit einer Notiz. Unter Sales > Orders werden solche Bestellungen nur angezeigt, wenn der Filter Order Status auf Missing Orders gesetzt ist.

Order Status After Payment (Standard Processing): die Zahlung wurde bestätigt. Eine Notiz zeigt die GoPay-Zahlungs-ID.

GoPay Payment On Hold Status (Standard Pending): GoPay hat die Zahlung bestätigt, aber Betrag, Währung oder Bestellnummer stimmen nicht mit der Bestellung überein; oder die Zahlung kam, nachdem die Bestellung storniert oder erstattet worden war; oder die Zahlung ist nur vorautorisiert, und das Geld ist noch nicht erfasst. Die Notiz erklärt es. Eine vorautorisierte Zahlung muss bei GoPay erfasst werden; danach wechselt die Bestellung in den Status „bezahlt“, sobald GoPay die Zahlung als bezahlt meldet.

Refunded Status (Standard Refunded): die GoPay-Zahlung der Bestellung wurde vollständig erstattet, entweder über die Erweiterung oder im GoPay-Konto.

Wird ein weiterer Zahlungsversuch zu einer bereits bezahlten Bestellung ebenfalls bezahlt, oder wird eine ältere Bestellung desselben Warenkorbs bezahlt, bleibt die bezahlte Bestellung unverändert. Eine Notiz bittet Sie, das Duplikat im GoPay-Konto zu erstatten. Eine ähnliche Notiz wird hinzugefügt, wenn eine GoPay-Zahlung für eine Bestellung bezahlt wird, die bereits ohne GoPay als bezahlt markiert wurde, zum Beispiel manuell. Eine stornierte oder erstattete Bestellung wird durch eine spätere Benachrichtigung nie wieder geöffnet.

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

Reiter VibeFox GoPay Gateway

Öffnen Sie unter Sales > Orders eine mit GoPay bezahlte Bestellung. Am unteren Rand der Bestellseite, neben History und Additional, zeigt der Reiter VibeFox GoPay Gateway die GoPay payment ID (bei Sandbox-Zahlungen mit der Kennzeichnung Sandbox), den GoPay state und das Zahlungsinstrument, den Payment amount, Paid / refunded, Needs review mit dem Grund, wenn die Bestellung auf Halt steht, das Erstattungsformular, den Erstattungsverlauf und die GoPay notes der Bestellung. Der Reiter wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Erstattungen

Geben Sie im Reiter den Amount ein (der noch nicht erstattete Betrag wird eingetragen), optional einen Reason (optional), und klicken Sie auf Refund via GoPay. Bestätigen Sie die Abfrage Refund this amount through GoPay? This cannot be undone. Vollständige und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). GoPay akzeptiert Teilerstattungen nur bis 24 Stunden nach der Zahlung. Erstattungen erfolgen in dem Betrag und der Währung, die GoPay belastet hat; nach einer Abweichung von Betrag oder Währung können Sie daher bis zu dem Betrag erstatten, den der Kunde tatsächlich bezahlt hat. Erstattungen sind für bezahlte Bestellungen und für Bestellungen auf Halt nach einer Abweichung oder einer verspäteten Zahlung verfügbar. Die Erstattung wird im Modus gesendet, in dem die Zahlung erfolgte (Sandbox oder Produktion), daher müssen die Zugangsdaten dieses Modus gesetzt sein. Lehnt GoPay die Erstattung ab, zeigt der Reiter die Meldung von GoPay, und es wird keine Erstattung verbucht. Eine erfolgreiche Erstattung wird dem Erstattungsverlauf und den Notizen hinzugefügt; eine Erstattung, die GoPay zur späteren Verarbeitung angenommen hat, wird als angenommen vermerkt. Eine vollständige Erstattung setzt die Bestellung auf den Refunded Status, ohne den Kunden zu benachrichtigen und ohne Produkte in den Bestand zurückzubuchen, wie bei einer manuellen Statusänderung. Eine Teilerstattung ändert den Status nicht.

Produktrücksendungen unter Sales > Returns erstatten kein Geld über GoPay.

Erstattungen, die im GoPay-Konto vorgenommen werden, kommen per Benachrichtigung an. Eine vollständige Erstattung setzt die Bestellung auf den Erstattungsstatus; eine Teilerstattung fügt eine Notiz hinzu. Sie werden nicht in den Erstattungsverlauf des Reiters aufgenommen.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox GoPay Gateway ist der erste Block unter Extensions > Extensions > Payments > VibeFox GoPay 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 aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: opencart-payment-gopay 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. Nach einer Änderung der Shop-Adresse oder nachdem 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 GoPay Kunden an der Kasse nicht angezeigt. Wird dennoch eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Ein Admin-Benutzer, der im selben Browser im Admin-Bereich angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert als (unlicensed — visible to admins only), sodass Sie die Erweiterung einrichten und testen können, bevor Sie einen Schlüssel kaufen. Unter OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Anmeldung im Admin-Bereich nicht, daher ist ohne aktiven Schlüssel die Zahlungsart für alle Besucher 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 der Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Das Deinstallieren der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

GoPay does not appear at checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist, der aktuelle Modus GoID, Client ID und Client Secret hat und die Kassenwährung eine von CZK, EUR, PLN, USD, GBP, HUF, RON oder BGN 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 die Bestellung den in den Einstellungen festgelegten Total erreicht.

The payment went through, but the order stays without a status: GoPay konnte die in den Einstellungen angezeigte Benachrichtigungs-URL nicht erreichen, und der Kunde ist nicht in den Shop zurückgekehrt. Entfernen Sie Passwortschutz oder Firewall-Regeln, die die URL blockieren. Prüfen Sie, ob die Zugangsdaten des Modus gesetzt sind, in dem die Zahlung erfolgte, da jede Benachrichtigung damit geprüft wird. Schalten Sie Logging ein und sehen Sie im Feld Log nach. GoPay wiederholt Benachrichtigungen, die keine erfolgreiche Antwort erhalten haben.

Notification answers Order not found: Die Zahlung wurde nicht von diesem Shop erstellt.

Notification answers Missing payment ID: Die Anfrage stammt nicht von GoPay, oder die URL wurde geändert. Es ist nichts zu tun.

Notification answers Payment state could not be verified: Die GoPay-API war nicht erreichbar, oder die Zugangsdaten dieses Modus fehlen oder sind falsch. GoPay wiederholt die Benachrichtigung.

Notification answers Busy, retry later: Die Bestellung wurde im selben Moment von einer anderen Anfrage verarbeitet. GoPay wiederholt die Benachrichtigung. Schalten Sie Logging ein, um den Grund zu sehen.

The customer sees an error after Confirm Order: Schalten Sie Logging ein und sehen Sie im Feld Log nach. Falsche Zugangsdaten oder Zugangsdaten des anderen Modus sind der häufigste Grund. Eine Meldung zu den Rechnungsdaten bedeutet, dass GoPay die E-Mail-Adresse, Telefonnummer oder Adresse nicht akzeptiert hat. This payment method is not available. Please reload the checkout page. bedeutet, dass die Kassensitzung nicht mehr zur Bestellung passt oder die Zahlungsart inzwischen deaktiviert wurde.

The customer comes back and sees We could not verify the GoPay payment. If money was charged, please contact us before paying again.: Der Rücklink passte zu keiner Bestellung des Shops, zum Beispiel weil er in einem anderen Browser geöffnet oder verändert wurde. Prüfen Sie die Zahlung im GoPay-Konto; die Benachrichtigung bestätigt weiterhin eine echte Zahlung.

Test payments do not confirm a live order: Sandbox und Produktion sind getrennt. Jede Zahlung wird in dem Modus geprüft, in dem sie erstellt wurde. Stellen Sie Test Mode auf den gewünschten Modus und verwenden Sie dessen Zugangsdaten.

Order is in the on hold status after payment: Lesen Sie die Notizen im Reiter VibeFox GoPay Gateway. Der gezahlte Betrag oder die Währung wich von der Bestellung ab, die Zahlung kam, nachdem die Bestellung storniert wurde, oder die Zahlung ist nur vorautorisiert.

Refund fails: Lesen Sie die Meldung von GoPay im Reiter. Eine Teilerstattung ist nur 24 Stunden nach der Zahlung möglich. Eine Meldung zum Modus bedeutet, dass die Zahlung im Sandbox- oder Produktionsmodus erfolgte und die Zugangsdaten dieses Modus nicht gesetzt sind. You do not have permission to refund (modify this extension). bedeutet, dass Ihre Benutzergruppe kein Recht hat, die Erweiterung zu ändern.

Für Entwickler: Bevor die Zahlung an GoPay gesendet wird, löst die Erweiterung das OpenCart-Ereignis gopay_p_payment_payload mit der Zahlungsanfrage und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox GoPay Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer seine eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die vier Bestellstatus-Felder, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (unter OpenCart 4 auch seine Ereignisse und seine Startup-Aktion, die im Wartungsmodus die Benachrichtigung und die Rückkehr des Kunden von GoPay durchlässt). Ist Delete Data on Uninstall eingeschaltet, werden die übrigen Gateway-Einstellungen (Titel, Beschreibung, Testmodus, Zugangsdaten, Sprache der Zahlungsseite, Logging), die zwischengespeicherten GoPay-Zugriffstoken und das Protokoll entfernt. Ist die Option ausgeschaltet, bleiben sie für eine spätere Neuinstallation erhalten. Die GoPay-Zahlungsdaten der Bestellungen und die Erstattungen bleiben immer erhalten, sodass früher bezahlte Bestellungen nach einer Neuinstallation weiterhin erstattet werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

Unter OpenCart 4 entfernen Sie auch die Dateien der Erweiterung: Gehen Sie nach der Deinstallation zu Extensions > Installer, klicken Sie in der Liste der installierten Erweiterungen neben VibeFox GoPay Gateway auf Uninstall (die orangefarbene −-Schaltfläche) und dann auf Delete (die rote Mülleimer-Schaltfläche), um das hochgeladene Paket zu entfernen.

GoPay ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit GoPay verbunden und wird von GoPay nicht unterstützt.