VibeFox Windcave for WooCommerce — Hilfe

Anforderungen

WordPress: 6.0 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer.

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

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert 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_windcave_payment_gateway auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > Windcave > Manage, oder klicken Sie auf der Seite Plugins 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 REST-API-Benutzernamen und Ihren Schlüssel ein: die UAT-Zugangsdaten für den Testmodus, die Live-Zugangsdaten für echte Zahlungen (siehe Konfiguration).

6. Wählen Sie die Transaktionsart und die Zahlungsarten, aktivieren Sie Enable/Disable und speichern Sie. Machen Sie eine Testzahlung mit eingeschaltetem Test mode und schalten Sie danach Test mode aus, um echte Zahlungen anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > Windcave. Solange der Testmodus eingeschaltet ist, zeigt die Seite Test mode is on: payments go to the Windcave UAT environment and no real money is taken. an. In der Liste der Zahlungsarten ist Windcave als einrichtungsbedürftig markiert, bis der aktuelle Modus sowohl einen API-Benutzernamen als auch einen API-Schlüssel hat. Die Plugin-Version wird unten auf der Seite angezeigt.

Allgemein

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

Title: der Name der Zahlungsart, den Kunden an der Kasse sehen. Standard: Credit/Debit Card (Windcave).

Description: der Text unter der Zahlungsart an der Kasse. Standard: You will be redirected to the secure Windcave payment page to complete your payment.

Windcave REST API

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

Test mode: Use the Windcave UAT test environment (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: aus.

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

Zahlung

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

Purchase (capture immediately): Das Geld wird eingezogen, sobald der Kunde bezahlt.

Auth (authorise now, capture later): Das Geld wird nur reserviert. Die Bestellung wird auf Wartend gesetzt. Sie ziehen das Geld mit Capture Windcave payment in den Bestellaktionen ein oder geben es frei, indem Sie den vollen Betrag erstatten. Nicht erfasste Autorisierungen verfallen nach einigen Tagen.

Payment methods: die Zahlungsarten, 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 müssen in Ihrem Windcave-Konto aktiviert sein. Lassen Sie das Feld leer, um alle im Konto aktivierten Zahlungsarten anzuzeigen. Standard: Cards.

Erweitert

Debug log: Log API requests and payment events. Das Protokoll finden Sie unter WooCommerce > Status > Logs, Quelle wcp_windcave_payment_gateway. Fehler und Warnungen werden immer protokolliert; diese Option fügt API-Anfragen und Zahlungsereignisse hinzu. API-Schlüssel, Kartendaten und personenbezogene Daten der Kunden werden maskiert. Standard: aus.

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Zahlungsdaten, die an Bestellungen gespeichert sind (Windcave-Transaktionsnummern, die für Erstattungen benötigt werden), bleiben immer erhalten. Standard: aus.

Benachrichtigungs-URL

Sie müssen bei Windcave keine Benachrichtigungs-URL einrichten. Das Plugin übermittelt seine Rücksprung-Adressen und seine Benachrichtigungsadresse bei jeder Zahlungssitzung. Windcave sendet die Benachrichtigung (Fail-Proof Result Notification) an https://your-site/wc-api/windcave_p_notification/. Weder die Rückkehr des Kunden noch die Benachrichtigung werden von Windcave signiert. Deshalb vertraut das Plugin ihnen nie allein: Es liest das Ergebnis der Sitzung immer über die REST-API von Windcave, mit den Zugangsdaten der Umgebung, in der die Sitzung erstellt wurde.

Kasse

Der Kunde wählt die Zahlungsart (standardmäßig Credit/Debit Card (Windcave)) und gibt die Bestellung auf. Das Plugin erstellt eine Windcave-Zahlungssitzung für den Bestellbetrag in der Bestellwährung und leitet den Kunden auf die Windcave Hosted Payment Page weiter. Die Bestellnummer wird als Händlerreferenz übermittelt, zusammen mit der Shop-Sprache sowie Name, E-Mail-Adresse, Telefonnummer und Rechnungs- und Lieferadresse des Kunden. Im Testmodus zeigt der Kassen-Block unter der Zahlungsart den Hinweis Test mode: payments go to the Windcave UAT environment, no real money is taken. an.

Nach der Zahlung kehrt der Kunde zur Seite „Bestellung eingegangen“ Ihres Shops zurück. Die Bestellung wird erst als bezahlt markiert, wenn Windcave bestätigt: Das Plugin fragt das Ergebnis der Sitzung über die REST-API von Windcave ab, sowohl wenn der Kunde zurückkehrt als auch wenn die Benachrichtigung von Windcave eintrifft. Eine Sperre pro Bestellung sorgt dafür, dass die Zahlung nur einmal verbucht wird. Ist das Ergebnis noch nicht bekannt, prüft die Seite „Bestellung eingegangen“ es noch einmal und zeigt 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. an.

Kehrt der Kunde ohne abgeschlossene Zahlung zurück, zeigt die Kassenseite (oder die Seite Pay for order, falls der Versuch dort begann) eine der folgenden Meldungen:

Declined: Ihre Zahlung wurde abgelehnt. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart.

Cancelled or expired: Die Zahlung wurde auf der Windcave-Seite nicht abgeschlossen. Ihre Bestellung ist gespeichert. Sie können es erneut versuchen oder eine andere Zahlungsart wählen.

Not confirmed yet: Wir konnten Ihre Zahlung noch nicht bestätigen. Falls Sie die Zahlung abgeschlossen haben, zahlen Sie bitte nicht erneut. Sie erhalten eine Bestätigungs-E-Mail, sobald Windcave sie bestätigt.

Return could not be processed: Wir konnten Ihre Rückkehr von der Zahlungsseite nicht verarbeiten. Wenn Ihnen ein Betrag belastet wurde, kontaktieren Sie uns bitte, bevor Sie erneut zahlen.

Der Warenkorb wird nicht geleert und der Bestand nicht reduziert, bevor der Kunde bezahlt. Ein Kunde kann eine unbezahlte Bestellung erneut bezahlen, zum Beispiel über die Seite Pay for order. Ein neuer Versuch prüft zuerst die vorherige Sitzung: Ist sie bereits bezahlt, wird keine zweite Zahlung erstellt. Hat der Kunde die Zahlungsseite nie benutzt und hat sich die Bestellung nicht geändert, wird er zur selben Seite zurückgeschickt. Wird die vorherige Zahlung in diesem Moment 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, sieht der Kunde eine kurze Meldung: dass Windcave die Zahlung mit den Daten dieser Bestellung nicht starten konnte oder dass der Zahlungsdienst vorübergehend nicht verfügbar ist. Der Grund wird den Bestellnotizen hinzugefügt. 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.

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.

Das Plugin bietet keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, kein eingebettetes Kartenformular auf Ihrer Website (der Kunde zahlt immer auf der Windcave-Seite), keine Unterstützung der PxPay-2.0-API und keine Aufschläge. Wenn Windcave einen Aufschlag hinzufügt, wird die Bestellung mit der Haupttransaktion abgeglichen.

Bestellungen und Erstattungen

Bestellstatus

Pending payment: Der Kunde wurde zu Windcave geschickt und hat noch nicht bezahlt, oder Windcave hat die Zahlung noch nicht bestätigt. Bricht der Kunde ab oder läuft die Sitzung ab, bleibt die Bestellung auf Zahlung ausstehend und eine Notiz wird hinzugefügt.

Processing or Completed: Eine Purchase-Zahlung wurde bestätigt. WooCommerce setzt wie üblich In Bearbeitung oder bei Bestellungen ohne Versand Abgeschlossen. Die Bestellnotiz zeigt den Betrag, die Windcave-Transaktionsnummer, den Autorisierungscode, den Kartentyp mit maskierter Kartennummer und die Umgebung (UAT oder Live). Die Transaktionsnummer der Bestellung ist die Windcave-Transaktionsnummer.

On hold (authorised): Eine Auth-Zahlung wurde genehmigt, aber noch nicht erfasst. Die Bestellnotiz erklärt, wie Sie sie erfassen oder freigeben.

On hold (does not match): Windcave meldete einen anderen Betrag, eine andere Währung, Händlerreferenz oder Transaktionsart als die Bestellung (zum Beispiel wurde die Bestellung bearbeitet, nachdem die Zahlung begonnen hatte). Die Notiz listet die Abweichungen auf. Prüfen Sie die Zahlung in Windcave Payline, bevor Sie versenden, und erstatten Sie sie gegebenenfalls.

Failed: Die Zahlung wurde abgelehnt. Die Notiz zeigt den Antworttext und den Code von Windcave. Der Kunde kann es erneut versuchen.

Trifft eine genehmigte Zahlung für eine stornierte Bestellung ein oder eine zweite genehmigte Zahlung für eine bereits bezahlte Bestellung, bleibt die Bestellung unverändert. Eine Notiz mit der Transaktionsnummer fordert Sie auf, die Zahlung in Windcave Payline zu erstatten (oder die stornierte Bestellung manuell wiederherzustellen).

Erfassung (Auth-Modus)

Öffnen Sie die Bestellung, wählen Sie Capture Windcave payment bei den Bestellaktionen und klicken Sie auf die Schaltfläche zum Aktualisieren. Die Aktion erscheint nur bei einer Bestellung auf Wartend mit einer Autorisierung, die noch nicht erfasst oder freigegeben wurde. Der Bestellbetrag wird erfasst, die Erfassung wird den Bestellnotizen hinzugefügt und die Bestellung wird als bezahlte Bestellung weitergeführt (meist In Bearbeitung). Akzeptiert Windcave die Erfassung nicht, zeigt der Bestellbildschirm Windcave capture failed: mit dem Grund, und der Grund wird den Bestellnotizen hinzugefügt.

Erstattungen

Öffnen Sie die Bestellung, klicken Sie auf Refund, geben Sie den Betrag ein und klicken Sie auf Refund via Windcave. Volle und teilweise Erstattungen werden unterstützt. Die Erstattung wird an die Umgebung (UAT oder Live) und an das Konto gesendet, in dem die Zahlung erfolgte. Daher müssen die Zugangsdaten dieser Umgebung gespeichert sein. Eine erfolgreiche Erstattung wird mit der Windcave-Transaktionsnummer den Bestellnotizen hinzugefügt.

Bei einer nicht erfassten Auth-Zahlung ist nur eine vollständige Erstattung möglich: Sie gibt die Autorisierung frei (storniert sie). Ein Teilbetrag führt zu einer Fehlermeldung, die Sie auffordert, den vollen Betrag zu erstatten oder die Zahlung zuerst zu erfassen.

Lehnt Windcave die Erstattung ab, zeigt WooCommerce Windcave declined the refund: mit dem Grund, und es wird keine Erstattung erfasst. Verarbeitet Windcave die Erstattung noch, zeigt WooCommerce 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. In Windcave Payline vorgenommene Erstattungen werden dem Shop nicht gemeldet.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > Windcave. 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 für eine Domain. Das Entfernen des Schlüssels von einer Website gibt den Domain-Platz nicht frei. Geben Sie ihn in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Windcave 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 Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen: Bereits gestartete Zahlungen werden weiterhin bestätigt, Erstattungen und Erfassungen funktionieren.

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

Fehlerbehebung

Windcave does not appear at 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.

The payment went through, but the order stays Pending payment: Das Plugin konnte das Ergebnis von Windcave noch nicht abrufen. Öffnen Sie die Bestellnotizen: Eine Notiz nennt den Zeitpunkt und den Grund, warum die Sitzung nicht geprüft werden konnte. Prüfen Sie, dass die Zugangsdaten der Umgebung der Zahlung gespeichert und korrekt sind. Die Prüfung wiederholt sich, wenn Windcave die Benachrichtigung erneut sendet (das Plugin antwortet mit einem Fehler, bis das Ergebnis geprüft werden kann, damit Windcave es erneut versucht), und wenn der Kunde die Seite „Bestellung eingegangen“ öffnet. Ihr Server muss Anfragen von Windcave an https://your-site/wc-api/windcave_p_notification/ annehmen.

Authentication failed in the order notes or the log: Der REST-API-Benutzername oder -Schlüssel ist falsch oder gehört zur anderen Umgebung. UAT-Zugangsdaten funktionieren nur im Testmodus, Live-Zugangsdaten nur im Live-Modus. PxPay-Schlüssel funktionieren nicht.

The customer sees that Windcave could not start the payment with the details of this order: Windcave hat die Sitzungsanfrage abgelehnt, zum Beispiel wegen der Währung oder einer Zahlungsart, die in Ihrem Konto nicht aktiviert ist. Der genaue Grund steht in den Bestellnotizen und im Protokoll.

Order is On hold after payment: Lesen Sie die Bestellnotiz. Entweder handelt es sich um 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, versenden oder erstatten Sie die Zahlung.

Test payments and live payments: UAT und Live sind voneinander getrennt. Jede Sitzung wird in der Umgebung geprüft, in der sie erstellt wurde. Erstattungen und Erfassungen gehen in die Umgebung der Zahlung, auch wenn Sie Test mode später umschalten. Bestellungen, die mit Version 1.0 des Plugins erstellt wurden, verwenden die Umgebung der alten Einstellung API URL.

Refund fails with a message about the environment: Die Zahlung erfolgte in UAT oder Live, und für diese Umgebung sind keine Zugangsdaten gespeichert. Geben Sie sie ein und versuchen Sie es erneut.

Capture Windcave payment is missing in the order actions: Die Aktion wird nur bei Bestellungen auf Wartend angezeigt, die mit Auth bezahlt wurden und noch nicht erfasst oder freigegeben sind.

Where to find details: Fehler und Warnungen werden immer in WooCommerce > Status > Logs, Quelle wcp_windcave_payment_gateway, geschrieben. Aktivieren Sie Debug log, um auch die API-Anfragen und Zahlungsereignisse zu protokollieren.

The license block shows an error: 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.

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 Einstellungen des Gateways, die Plugin-Optionen und die Protokolle (Protokolldateien, auch rotierte, und Datenbank-Protokolleinträge) werden nur entfernt, wenn Clean uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Windcave-Transaktionsnummern.

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