VibeFox Windcave for OpenCart — Hilfe

Voraussetzungen

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.

Windcave-Konto: Sie benötigen ein Windcave-Händlerkonto mit Zugangsdaten für die REST API: einen API-Benutzernamen und einen API-Schlüssel. Windcave stellt sie getrennt für die UAT-Testumgebung (uat.windcave.com) und für die Produktivumgebung (sec.windcave.com) aus. Fragen Sie den Windcave-Support oder Ihren Kundenbetreuer danach. PxPay-Schlüssel funktionieren mit dieser Erweiterung nicht. Die Zahlungsmethoden, die Sie anbieten möchten (Karten, Wallets und andere), müssen in Ihrem Windcave-Konto aktiviert sein.

Benachrichtigung: Ihr Shop muss aus dem Internet erreichbar sein, damit Windcave seine Zahlungsbenachrichtigung senden kann. Dafür muss bei Windcave nichts eingerichtet werden.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer 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 OpenCart-3-Paket wcp_windcave_payment_gateway-oc3-(version).ocmod.zip und das OpenCart-4-Paket wcp_windcave_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-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_windcave_payment_gateway-oc3-(version).ocmod.zip. Die Erweiterung hat keine OCMOD-Modifikationen, 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 Windcave 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 in License key im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate (siehe License key).

4. Geben Sie Ihren REST-API-Benutzernamen und Ihren Schlüssel ein: die UAT-Zugangsdaten für den Testmodus und die Produktiv-Zugangsdaten für echte Zahlungen (siehe Configuration).

5. Wählen Sie die Transaktionsart und die Zahlungsmethoden, aktivieren Sie Enable/Disable und klicken Sie auf Save. Führen Sie bei aktivem Test mode eine Testzahlung durch und deaktivieren Sie dann Test mode, um echte Zahlungen anzunehmen.

OpenCart 4

1. Gehen Sie im Admin-Bereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei wcp_windcave_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 Windcave 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 Windcave-Zugangsdaten und die Einstellungen ein wie in den Schritten 3 bis 5 für OpenCart 3. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich. Nur die Benachrichtigungsadresse ist anders (siehe Windcave REST API).

Eine neue Installation startet mit deaktivierter Zahlungsart.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit. Die Abschnitte sind links aufgelistet; die Schaltfläche Save unter der Liste speichert die gesamte Seite. Solange der Testmodus aktiv ist, zeigt die Seite Test mode is on: payments go to the Windcave UAT environment and no real money is taken. Ist die Zahlungsart aktiviert, aber im aktuellen Modus fehlen Benutzername oder Schlüssel der API, warnt die Seite, dass sie im Checkout ausgeblendet ist, zum Beispiel Windcave is enabled but the UAT API username / key are empty — the payment method is hidden at checkout. Ohne das Recht, die Erweiterung zu ändern, zeigt die Seite die Einstellungen an, kann sie aber nicht speichern.

Beim Speichern darf Title nicht leer sein und höchstens 128 Zeichen lang sein (Enter a title for the payment method (at most 128 characters).), Sort Order muss eine ganze Zahl sein (Sort Order must be a whole number.), Total muss eine Zahl größer oder gleich 0 sein (Total: enter a number, 0 or greater.), und die gewählte Geo Zone sowie die Bestellstatus müssen existieren. Andernfalls wird nichts gespeichert, und die Seite zeigt den Fehler an.

Windcave

Enable/Disable: Enable Windcave payments schaltet die Zahlungsart ein oder aus. Standard: off.

Title: der Name der Zahlungsart, den Kunden im Checkout sehen. Er wird auch als Zahlungsart in der Bestellung gespeichert. Standard: Credit/Debit Card (Windcave). Pflichtfeld, höchstens 128 Zeichen.

Description: der Text, der dem Kunden im Schritt Confirm Order oberhalb der Bestätigungsschaltfläche angezeigt wird. Standard: You will be redirected to the secure Windcave payment page to complete your payment.

Sort Order: die Position von Windcave unter den Zahlungsarten im Checkout. Lassen Sie das Feld leer oder geben Sie eine ganze Zahl ein; negative Zahlen sind erlaubt.

Geo Zone: bietet Windcave nur für Rechnungsadressen in der gewählten Geo Zone an. Standard: All zones. Geo Zones werden unter System > Localisation > Geo Zones eingerichtet.

Total: der Checkout-Gesamtbetrag in der Standardwährung des Shops, den eine Bestellung erreichen muss, bevor Windcave angeboten wird: eine Zahl größer oder gleich 0. Lassen Sie das Feld leer, um es bei jedem Betrag anzubieten.

Windcave REST API

Geben Sie die von Windcave ausgestellten Zugangsdaten der REST API ein (Benutzername und API-Schlüssel, nicht die PxPay-Schlüssel). Produktiv- und UAT-Zugangsdaten können nebeneinander gespeichert werden. Der Testmodus verwendet nur die UAT-Zugangsdaten, der Live-Modus nur die Produktiv-Zugangsdaten. Der Abschnitt verlinkt auf die Dokumentation der Windcave REST API.

Test mode: nutzt die UAT-Testumgebung von Windcave (uat.windcave.com). Es wird kein echtes Geld eingezogen. Neue Zahlungen verwenden die UAT-Zugangsdaten. Erstattungen und Erfassungen gehen immer in die Umgebung, in der die Bestellung bezahlt wurde. Standard: off.

Production API username: der REST-API-Benutzername für sec.windcave.com.

Production API key: der REST-API-Schlüssel für sec.windcave.com.

UAT API username: der REST-API-Benutzername für uat.windcave.com (Testmodus).

UAT API key: der REST-API-Schlüssel für uat.windcave.com (Testmodus).

Gespeicherte API-Schlüssel 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 Schlüssel zu entfernen, aktivieren Sie unter dem Feld Clear the saved key on save und klicken Sie auf Save.

Notification URL: zeigt die Adresse, an die Windcave seine Zahlungsbenachrichtigung sendet (Fail-Proof Result Notification). Sie wird aus der Storefront-Adresse Ihrer OpenCart-Installation gebildet und sieht auf OpenCart 3 etwa so aus: https://your-store/index.php?route=extension/payment/wcp_windcave_payment_gateway/notify und auf OpenCart 4 so: https://your-store/index.php?route=extension/wcp_windcave_payment_gateway/payment/wcp_windcave_payment_gateway.notify. Bei Windcave ist nichts zu konfigurieren: Die Erweiterung übermittelt ihre Rücksprungadressen und diese Benachrichtigungsadresse bei jeder Zahlungssitzung. Die Adresse muss aus dem Internet erreichbar sein, sonst werden Bestellungen nur bestätigt, wenn der Kunde von Windcave zurückkehrt. Weder die Rückkehr des Kunden noch die Benachrichtigung ist von Windcave signiert. Deshalb vertraut die Erweiterung ihnen nie allein: Sie liest das Ergebnis der Sitzung immer über die Windcave REST API, mit den Zugangsdaten der Umgebung, in der die Sitzung erstellt wurde.

Payment

Transaction type: wie die Zahlung eingezogen wird. Standard: Purchase.

Payment methods: die Methoden, die auf der Windcave-Zahlungsseite angezeigt werden: Cards, Account2Account (Banküberweisung in Neuseeland), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm. Sie können mehrere auswählen. Die Methoden müssen in Ihrem Windcave-Konto aktiviert sein. Lassen Sie das Feld leer (Every method enabled on the account), um alle im Konto aktivierten Methoden anzuzeigen. Standard: Cards.

Orders

OpenCart legt die Bestellung im Schritt Confirm Order ohne Status an (eine fehlende Bestellung). Die Bestellung erhält erst einen Status, nachdem Windcave die Zahlung genehmigt hat. Jedes Feld unten listet Ihre Bestellstatus aus OpenCart auf.

Order Status After Payment: wird nach einem genehmigten Purchase oder nach einer Erfassung gesetzt. Standard: Processing.

Windcave Payment On Hold Status: eine Auth-Zahlung, die autorisiert, aber noch nicht erfasst ist, oder eine genehmigte Zahlung, die nicht zur Bestellung passt (Betrag, Währung, Referenz). Eine Notiz erklärt den Grund; prüfen Sie sie vor dem Versand. Standard: Pending, da 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: wird von der Erweiterung nicht gesetzt. Eine genehmigte Zahlung für eine Bestellung in diesem Status ändert sie nicht; eine Notiz fordert Sie auf, sie in Windcave Payline zu erstatten oder die Bestellung wiederherzustellen. Standard: Canceled.

Refunded Status: wird gesetzt, nachdem die Zahlung auf der Bestellseite vollständig erstattet oder die Autorisierung freigegeben wurde. Standard: Refunded.

Advanced

Debug log: protokolliert API-Anfragen und Zahlungsereignisse in windcave_p_debug.log.php im Logs-Ordner von OpenCart (storage/logs). Die Datei lässt sich nicht über den Webbrowser öffnen. Solange diese Option aus ist, werden nur Fehler und Warnungen protokolliert. API-Schlüssel, Kartendaten und personenbezogene Kundendaten werden nie protokolliert. Standard: off.

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

Clean uninstall: entfernt beim Deinstallieren der Erweiterung deren Einstellungen und Protokolle. Zahlungsdaten, die mit Bestellungen gespeichert sind (Windcave-Transaktions-IDs, die für Erstattungen nötig sind), bleiben immer erhalten. Standard: off.

Die Version der Erweiterung wird am Ende des Abschnitts angezeigt.

Import / Export

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

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

Checkout

Im Schritt Payment Method wählt der Kunde die Zahlungsart (standardmäßig Credit/Debit Card (Windcave)). Im Schritt Confirm Order sieht der Kunde Ihre Beschreibung; im Testmodus außerdem Test mode: payments go to the Windcave UAT environment, no real money is taken. OpenCart legt die Bestellung in diesem Schritt an, noch ohne Status. Wenn der Kunde auf Confirm Order klickt, erstellt die Erweiterung eine Windcave-Zahlungssitzung für den Bestellbetrag in der Bestellwährung und leitet den Kunden zur Windcave Hosted Payment Page weiter. Die OpenCart-Bestellnummer wird als Händlerreferenz übermittelt, zusammen mit der Sprache der Bestellung sowie Name, E-Mail, Telefonnummer und Rechnungsadresse des Kunden (und der Lieferadresse, wenn die Bestellung versendet werden muss). 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 Checkout-Seite auf Confirm Order.

Nach der Zahlung kehrt der Kunde in Ihren Shop zurück. Die Bestellung wird erst als bezahlt markiert, nachdem Windcave sie bestätigt hat: Die Erweiterung fragt das Ergebnis der Sitzung über die Windcave REST API ab, sowohl bei der Rückkehr des Kunden als auch wenn die Benachrichtigung von Windcave eingeht. Eine Sperre pro Warenkorb stellt sicher, dass die Zahlung nur einmal angewendet wird. Die Bestellung erhält danach ihren Status auf die übliche Weise von OpenCart, mit den üblichen Bestell-E-Mails und der Bestandsaktualisierung, und der Kunde sieht die Erfolgsseite der OpenCart-Bestellung mit Your Windcave payment has been received. Bei einer Bestellung im Haltestatus (eine Autorisierung oder eine Zahlung, die nicht zur Bestellung passt) zeigt die Seite Your payment was received by Windcave. The store will check it before processing your order — please do not pay again.

Kehrt der Kunde von der genehmigten Zahlung zurück, das Ergebnis ist aber noch nicht bekannt, zeigt eine Seite Payment confirmation den Hinweis We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again. und eine Schaltfläche Check again. Die Benachrichtigung setzt den Bestellstatus, sobald Windcave die Zahlung bestätigt.

Kehrt der Kunde zurück, ohne dass eine Zahlung abgeschlossen wurde, bleibt die Bestellung ohne Status, der Warenkorb bleibt erhalten, und die Checkout-Seite zeigt eine dieser Meldungen:

Auf OpenCart 4 werden diese Meldungen über der Checkout-Seite angezeigt.

Der Kunde kann es mit demselben Warenkorb erneut versuchen (OpenCart 3 legt jedes Mal, wenn der Schritt Confirm Order angezeigt wird, eine neue Bestellung an; OpenCart 4 behält für den Checkout eine Bestellung und aktualisiert sie, daher wird dieselbe Bestellung in einer neuen Windcave-Sitzung bezahlt). Ein neuer Versuch prüft zuerst die früheren Sitzungen des Warenkorbs: Ist eine bereits bezahlt, wird diese Zahlung übernommen, der Kunde gelangt zur Erfolgsseite und es wird keine zweite Zahlung gestartet; hat der Kunde die Zahlungsseite nie benutzt und hat sich die Bestellung nicht geändert, wird er zurück auf dieselbe Seite geschickt. Wird die vorherige Zahlung in diesem Moment gerade bestätigt, sieht der Kunde Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again.

Kann Windcave die Zahlung nicht starten, bleibt der Kunde im Schritt Confirm Order mit einer Meldung über der Schaltfläche: Windcave could not start the payment with the details of this order. Please check your billing details and try again, or choose another payment method. oder The payment could not be started because the payment service is temporarily unavailable. Please try again in a moment or choose another payment method. Der Grund wird im Protokoll festgehalten. Hat der aktuelle Modus keine Zugangsdaten, sieht der Kunde This payment method is not available at the moment. Please choose another payment method or contact us.

Auf OpenCart 4, wenn die Bestellung des Checkouts einen Status erhalten hat, ohne dass eine Windcave-Zahlung vorliegt, oder der Shop sie inzwischen geschlossen hat, schickt der nächste Confirm Order den Kunden mit This order can no longer be paid. Please check your cart and confirm the order again. über der Checkout-Seite zurück zum Checkout, und der Warenkorb wird mit einer neuen Bestellung bezahlt. Ist die Bestellung des Checkouts bereits bezahlt, der Warenkorb seitdem aber geändert, auch durch eine neue Menge, wird der Kunde zum Checkout zurückgeschickt, und der neue Warenkorb wird mit einer neuen Bestellung bezahlt.

Die Benachrichtigung und die Rückkehr des Kunden funktionieren auch, während der Shop im Wartungsmodus ist: OpenCart 3 lässt Anfragen von Zahlungserweiterungen durch, und auf OpenCart 4 fügt die Erweiterung dafür eine Startaktion hinzu.

Die Erweiterung hat keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, kein eingebettetes Kartenformular auf Ihrer Website (der Kunde bezahlt immer auf der Windcave-Seite), keine Unterstützung der PxPay-2.0-API und erhebt keine Aufpreise. Erhebt Windcave einen Aufpreis, wird die Bestellung mit der Haupttransaktion abgeglichen.

Bestellungen und Erstattungen

Order statuses

Kein Status (fehlende Bestellung): Der Kunde wurde zu Windcave weitergeleitet und hat nicht bezahlt, Windcave hat die Zahlung noch nicht bestätigt, oder die Zahlung wurde abgelehnt, abgebrochen oder ist abgelaufen. Unter Sales > Orders werden solche Bestellungen nur mit dem Filter Order Status auf Missing Orders angezeigt.

Order Status After Payment (Standard Processing): eine Purchase-Zahlung wurde genehmigt und passt zur Bestellung. Eine Notiz zeigt den Betrag, die Transaktions-ID, den Autorisierungscode, den Kartentyp mit der maskierten Kartennummer und die Umgebung (UAT oder Produktion).

Windcave Payment On Hold Status, autorisiert (Standard Pending): eine Auth-Zahlung wurde genehmigt, aber noch nicht erfasst. Die Notiz erklärt, wie Sie sie erfassen oder freigeben.

Windcave Payment On Hold Status, passt nicht (Standard Pending): Windcave meldete einen anderen Betrag, eine andere Währung, eine andere Händlerreferenz oder eine andere Transaktionsart als die Bestellung (zum Beispiel wurde der Warenkorb nach Beginn der Zahlung in einem anderen Tab geändert), oder die Bestellung hatte bereits einen von jemand anderem gesetzten Status. Die Notiz listet die Unterschiede auf. Das genehmigte Geld kann trotzdem über den Tab der Bestellung erstattet werden. Prüfen Sie die Zahlung vor dem Versand in Windcave Payline und erstatten Sie sie bei Bedarf.

Refunded Status (Standard Refunded): die Zahlung wurde über die Erweiterung vollständig erstattet oder die Autorisierung wurde freigegeben.

Geht eine genehmigte Zahlung für eine Bestellung im Status Cancelled Order Status ein oder eine zweite genehmigte Zahlung für eine bereits bezahlte Bestellung oder einen bereits bezahlten Warenkorb, wird die Bestellung nicht verändert. Eine Notiz mit der Transaktions-ID fordert Sie auf, sie in Windcave Payline zu erstatten (oder die stornierte Bestellung manuell wiederherzustellen).

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

VibeFox Windcave Payment Gateway tab

Öffnen Sie unter Sales > Orders eine mit Windcave bezahlte Bestellung. Unten auf der Bestellseite, neben History und Additional, zeigt der Tab VibeFox Windcave Payment Gateway die Transaction ID, die Session ID, den Type / status mit der Umgebung, den Amount paid, den Auth code / card, die Capture transaction bzw. eine freigegebene Autorisierung, den Payment total / refunded, einen Hinweis Test mode (UAT) bei Testzahlungen, die Erfassungsschaltfläche, das Erstattungsformular mit Verlauf, die Windcave sessions of this cart und die Windcave notes der Bestellung. Der Tab wird Benutzern angezeigt, die Zugriff auf die Erweiterung haben.

Capture (Auth mode)

Bei einer Bestellung im Windcave Payment On Hold Status mit einer Autorisierung, die noch nicht erfasst oder freigegeben wurde, zeigt der Tab Capture Windcave payment. Klicken Sie darauf und bestätigen Sie Capture the authorised amount through Windcave now? Der autorisierte Betrag wird erfasst, die Bestellung wechselt in Order Status After Payment, und die Erfassungstransaktion wird im Tab angezeigt. Akzeptiert Windcave die Erfassung nicht, zeigt der Tab Windcave capture failed: mit dem Grund, der Grund wird den Notizen hinzugefügt, und die Bestellung bleibt im Haltestatus. Die Erfassung erfordert das Recht, die Erweiterung zu ändern, und die Zugangsdaten der Umgebung der Zahlung.

Refunds

Geben Sie im Tab VibeFox Windcave Payment Gateway den Amount ein (der noch nicht erstattete Betrag wird vorausgefüllt), optional einen Reason (optional), und klicken Sie auf Refund via Windcave. Bestätigen Sie die Frage Refund this amount through Windcave? This cannot be undone. Volle und teilweise Erstattungen werden unterstützt. Sie benötigen das Recht, die Erweiterung zu ändern (festgelegt unter System > Users > User Groups). Erstattungen werden gegen den Betrag und die Währung gerechnet, die Windcave genehmigt hat; nach einer Abweichung können Sie also bis zu dem erstatten, was der Kunde tatsächlich bezahlt hat, nicht bis zum Bestellbetrag. Eine Erstattung nach einer Erfassung geht auf die Erfassungstransaktion. Die Erstattung wird an die Umgebung (UAT oder Produktion) und das Konto gesendet, in dem die Zahlung getätigt wurde; daher müssen die Zugangsdaten dieser Umgebung gespeichert sein. Eine erfolgreiche Erstattung wird mit der Windcave-Transaktions-ID dem Erstattungsverlauf und den Notizen hinzugefügt. Eine vollständige Erstattung setzt die Bestellung auf Refunded Status, ohne den Kunden zu benachrichtigen und ohne Waren an den Bestand zurückzugeben, ähnlich wie eine manuelle Statusänderung. Eine teilweise Erstattung ändert den Status nicht.

Bei einer nicht erfassten Auth-Zahlung lautet die Schaltfläche Release authorisation (void), und es kann nur der volle Betrag freigegeben werden. Ein Teilbetrag führt zu einem Fehler mit dem Hinweis, dass Sie den vollen Betrag erstatten oder die Zahlung zuerst erfassen müssen.

Lehnt Windcave die Erstattung ab, zeigt der Tab Windcave declined the refund: mit dem Grund, und es wird keine Erstattung erfasst. Verarbeitet Windcave die Erstattung noch, zeigt der Tab Windcave has not confirmed the refund yet. See the order notes., und die Erstattung wird nicht erfasst. Prüfen Sie die Transaktion in Windcave Payline: Wurde sie genehmigt, erfassen Sie die Erstattung manuell; andernfalls versuchen Sie es erneut. Ein wiederholter Versuch derselben Erstattung wird nicht zweimal an Windcave gesendet.

Produktrücksendungen unter Sales > Returns senden kein Geld über Windcave zurück. In Windcave Payline vorgenommene Erstattungen werden dem Shop nicht gemeldet.

Lizenzschlüssel

Die Erweiterung arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Windcave Payment Gateway ist der erste Block auf Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit, über den Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig 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-windcave und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Admin-Benutzer mit dem Recht Modify für die Erweiterung ändern. Die Texte des Blocks folgen der Admin-Sprache (Englisch und Russisch sind enthalten).

Wenn der Schlüssel nicht akzeptiert wird, zeigt 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 nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der 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 Windcave Kunden im Checkout 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-Bereich im selben Browser angemeldet ist, sieht die Zahlungsart im Shop weiterhin, markiert als (unlicensed — visible to admins only), damit 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 Admin-Anmeldung nicht, daher wird die Zahlungsart ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Admin-Bereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen: Bereits begonnene Zahlungen werden weiterhin über die Benachrichtigung oder die Rückkehr des Kunden bestätigt, und Erstattungen und Erfassungen funktionieren.

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

Fehlerbehebung

Windcave erscheint nicht im Checkout: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und der aktuelle Modus beide Zugangsdaten hat: UAT API username und UAT API key im Testmodus, Production API username und Production API key im Live-Modus. Die Einstellungsseite zeigt eine Warnung an, wenn sie 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.

Die Zahlung ist erfolgt, aber die Bestellung bleibt ohne Status: Die Erweiterung konnte das Ergebnis von Windcave noch nicht abrufen. Sehen Sie im Feld Log auf der Seite der Erweiterung nach: Fehler werden immer protokolliert, zum Beispiel wenn die Sitzung nicht geprüft werden konnte. Prüfen Sie, ob die Zugangsdaten der Umgebung der Zahlung gespeichert und korrekt sind. Die Prüfung wird wiederholt, wenn Windcave die Benachrichtigung erneut sendet (die Erweiterung antwortet dann mit payment could not be verified yet, retry later und einem Fehlercode, damit Windcave es erneut versucht), wenn der Kunde auf Check again klickt und wenn der Kunde eine neue Zahlung für denselben Warenkorb startet. Ihr Server muss Anfragen von Windcave an die in den Einstellungen angezeigte Notification URL annehmen.

Die Benachrichtigung antwortet order not found: Die Sitzung wurde nicht von diesem Shop erstellt, zum Beispiel eine Sitzung eines anderen Shops, der dasselbe Windcave-Konto verwendet. Sie wird ignoriert.

Authentication failed im Protokoll: Der Benutzername oder Schlüssel der REST API ist falsch oder gehört zur anderen Umgebung. UAT-Zugangsdaten funktionieren nur im Testmodus, Produktiv-Zugangsdaten nur im Live-Modus. PxPay-Schlüssel funktionieren nicht.

Der Kunde sieht, dass Windcave die Zahlung mit den Daten dieser Bestellung nicht starten konnte: Windcave hat die Sitzungsanfrage abgelehnt, zum Beispiel wegen der Währung oder einer Zahlungsmethode, die in Ihrem Konto nicht aktiviert ist. Der genaue Grund steht im Protokoll.

Der Kunde sieht nach Confirm Order This payment method is not available.: Die Checkout-Sitzung passt nicht mehr zur Bestellung, oder die Zahlungsart wurde inzwischen deaktiviert. Der Kunde lädt den Checkout neu.

Die Bestellung steht nach der Zahlung im Prüfstatus: Lesen Sie die Notizen im Tab VibeFox Windcave Payment Gateway. Entweder ist die Zahlung eine Auth-Zahlung, die auf die Erfassung wartet, oder der bezahlte Betrag, die Währung oder die Händlerreferenz wich von der Bestellung ab. Erfassen, erfüllen oder erstatten Sie die Zahlung.

Testzahlungen und Live-Zahlungen: UAT und Produktion sind getrennt. Jede Sitzung wird in der Umgebung geprüft, in der sie erstellt wurde, und Erstattungen und Erfassungen gehen in die Umgebung der Zahlung, auch wenn Sie Test mode später umschalten.

Die Erstattung schlägt mit einer Meldung zur Umgebung fehl: Die Zahlung wurde in UAT oder der Produktion getätigt, und für diese Umgebung sind keine Zugangsdaten gespeichert. Tragen Sie sie ein und versuchen Sie es erneut.

Capture Windcave payment fehlt im Tab der Bestellung: Die Schaltfläche wird nur für Bestellungen im Windcave Payment On Hold Status angezeigt, die mit Auth bezahlt und noch nicht erfasst oder freigegeben wurden, nur wenn die Zugangsdaten der Umgebung der Zahlung gespeichert sind, und nur für Benutzer, die die Erweiterung ändern dürfen.

Wo Sie Details finden: Fehler und Warnungen werden immer ins Protokoll geschrieben; aktivieren Sie Debug log, um zusätzlich die API-Anfragen und Zahlungsereignisse zu protokollieren.

Für Entwickler: Bevor die Windcave-Sitzung erstellt wird, löst die Erweiterung das OpenCart-Ereignis windcave_p_session_request mit den Sitzungsparametern und der Bestellung aus.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Payments und klicken Sie neben VibeFox Windcave Payment Gateway auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart entfernt immer die eigenen Einstellungen der Erweiterung: Enable/Disable, Sort Order, Geo Zone, Total und die Bestellstatus des Abschnitts Orders, die bei einer Neuinstallation auf ihre Standardwerte zurückgesetzt werden. Das OpenCart-Ereignis der Erweiterung wird ebenfalls entfernt (auf OpenCart 4 seine Ereignisse und seine Startaktion, die im Wartungsmodus die Benachrichtigung und die Rückkehr des Kunden durchlässt). Ist Clean uninstall aktiv, werden die übrigen Einstellungen (Titel, Beschreibung, Testmodus, API-Zugangsdaten, Transaktionsart, Zahlungsmethoden, Protokollierung) und das Protokoll entfernt. Ist die Option aus, bleiben sie für eine spätere Neuinstallation erhalten. Windcave-Sitzungen, Transaktionen und Erstattungen bleiben immer erhalten, sodass vorher bezahlte Bestellungen nach einer Neuinstallation weiter erstattet und erfasst werden können. Bestehende Bestellungen behalten ihre Zahlungsnotizen.

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

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