Windcave Terminal Zahlungsgateway
Windcave Terminal sendet einen Verkauf von der Kasse an ein Windcave-Terminal. Der Kunde bezahlt am Terminal, und die Kasse verbucht die Zahlung, sobald Windcave sie bestätigt.
Diese Seite beginnt an der Kasse. Für Filialadministratoren: Unter Windcave Terminal einrichten finden Sie die Zugangsdaten, die WP-Admin-Einstellungen und eine Anleitung zur Überprüfung.
Windcave Terminal benötigt WCPOS Pro ab Version 2.0 und die Erweiterung ab Version 1.0.
Nur Testzahlungen: Nehmen Sie über Windcave noch keine echten Kundenzahlungen entgegen. Windcave genehmigt jede POS-Integration, bevor sie echte Zahlungen entgegennimmt, und hat diese Integration noch nicht genehmigt. Die Erweiterung wurde noch nicht auf einem physischen Windcave-Terminal ausgeführt. Zahlungen und Rückerstattungen wurden mit einem Ersatz für den HIT-Dienst von Windcave getestet, der auf der Dokumentation von Windcave basiert. Führen Sie eine kleine UAT-Zahlung durch und erstatten Sie sie zurück, bevor Sie sich darauf verlassen.Was noch nicht getestet wurde
Kartenzahlung entgegennehmen
Wenn Kasse öffnen und schließen aktiviert ist, verbucht die Kasse keine Zahlung, solange sie geschlossen ist. Eine bereits entgegengenommene Kartenzahlung müsste dann zurückerstattet werden. Informationen zur Einstellung finden Sie unter Kassen.
- Drücken Sie im Warenkorb auf Kasse und tippen Sie auf der Registerkarte Zahlungen auf die Kachel Windcave Terminal. Wenn Ihre Terminals nach einer Unterschrift fragen, verwenden Sie stattdessen die Registerkarte Legacy: siehe Wenn das Terminal eine Frage stellt.
- Sehen Sie oberhalb des Tastenfelds nach. Wenn Terminal auswählen angezeigt wird, tippen Sie auf die Stations-ID des Terminals an Ihrer Kasse: den Namen, den Windcave jedem Terminal zuweist, etwa
DOCS-STATION-1. Wenn Terminal: und eine ID angezeigt werden, verwendet diese Kasse dieses Terminal. Drücken Sie auf Ändern, um ein anderes auszuwählen. Die Kasse merkt sich Ihre Auswahl. - Um einen Teil des offenen Betrags von der Karte abzubuchen, geben Sie den Betrag ein. Der Rest bleibt für eine weitere Zahlung offen.
- Drücken Sie auf An Windcave Terminal senden …. Die Kasse zeigt Am Terminal mit vier Schritten an: Gesendet, Am Terminal, Genehmigt und Eingezogen. Letzteres bedeutet, dass das Geld eingezogen wurde.
- Der Kunde hält die Karte an das Terminal, steckt sie ein oder zieht sie durch. Sobald die Zahlung eingezogen wurde und kein Betrag mehr offen ist, wird der Beleg geöffnet. Ist noch ein Betrag offen, nehmen Sie ihn mit einer anderen Kachel entgegen.

- Windcave Terminal — die Kachel, die nach dem Antippen umrandet angezeigt wird.
- Stations-IDs unter Terminal auswählen — tippen Sie auf die ID des Terminals an Ihrer Kasse. Sobald diese Kasse ein Terminal zugewiesen hat, zeigt diese Zeile Terminal: und dessen ID sowie Ändern an.
- Zu zahlen — der Betrag dieser Zahlung. Geben Sie einen kleineren Betrag ein, um einen Teil des offenen Betrags von der Karte abzubuchen.
- Gesamter offener Betrag — setzt den gesamten noch offenen Betrag wieder in Zu zahlen ein.
- An Windcave Terminal senden … — startet die Zahlung am Terminal. Die Schaltfläche ist ausgegraut, bis ein Terminal ausgewählt wurde.
- Legacy — die andere Registerkarte für Zahlungen über Gateways mit eigener Zahlungsseite. Verwenden Sie sie, wenn Ihr Terminal nach einer Unterschrift fragt.
Unter den vier Schritten öffnet Details ein Protokoll der Zahlung einschließlich der Station, an die sie gesendet wurde. Am Terminal sind Trinkgeld, Aufschlag und Bargeldauszahlung nicht möglich.
Wenn das Terminal eine Frage stellt
Ein Terminal kann anhalten und eine Frage stellen, etwa ob die Unterschrift des Kunden übereinstimmt. In dieser Version zeigt die Registerkarte Zahlungen solche Fragen nicht an. Die Registerkarte Legacy zeigt sie an:
- Öffnen Sie die Registerkarte Legacy und wählen Sie Windcave Terminal. Siehe Die Registerkarte Legacy.
- Starten Sie dort die Zahlung. Dabei wird der gesamte Bestellbetrag mit einer Zahlung beglichen.
- Wenn das Terminal eine Frage stellt, zeigt die Zahlungsseite sie mit den eigenen Schaltflächen des Terminals an, zum Beispiel JA und NEIN. Drücken Sie auf die passende Antwort.
Zahlung abbrechen
Drücken Sie auf Am Terminal abbrechen, bevor der Kunde bezahlt. Das funktioniert nur, solange das Terminal selbst ABBRECHEN anbietet. Andernfalls zeigt die Kasse Das Terminal bietet momentan keine Abbruchmöglichkeit. Brechen Sie den Vorgang am Terminal ab. an.
Ein Abbruch ist eine Anfrage. Wurde die Karte bereits eingelesen, kann die Zahlung trotzdem durchgeführt werden: Die Kasse zeigt Wird abgebrochen — es wird auf die Bestätigung des Terminals gewartet an, fragt weiter den Status ab und zeigt das Ergebnis. Warten Sie darauf, bevor Sie eine andere Zahlungsart verwenden.
Wenn die Kasse keine Antwort erhält, bietet sie Diese Zahlung freigeben an. Freigegeben bedeutet nicht abgebrochen: Drücken Sie erst darauf, nachdem eine Filialleitung das Windcave-Portal geprüft und festgestellt hat, dass für die Bestellung keine Zahlung genehmigt wurde. Danach kann die Bestellung mit einer anderen Zahlungsart bezahlt werden; die Kasse prüft das Terminal weiterhin.
Wenn etwas schiefgeht
Wenn der Kunde möglicherweise bezahlt hat
In diesen beiden Fällen wurde die Karte möglicherweise bereits belastet. Eine Filialleitung prüft zuerst das Windcave-Portal, in dem der Verkauf unter der Bestellnummer aufgeführt ist.
Terminalergebnis konnte nicht bestätigt werden. Prüfen Sie Windcave, bevor Sie die Zahlung erneut entgegennehmen. Die Kasse hat erneut nach einer bereits gesendeten Zahlung gefragt, aber Windcaves Antwort war unklar. Nehmen Sie die Zahlung nur erneut entgegen, nachdem eine Filialleitung im Portal nach dem Verkauf gesucht und keinen Eintrag gefunden hat.
Zahlung fehlgeschlagen: Das Terminal hat einen anderen Betrag bestätigt. Das Terminal hat einen anderen Betrag als den von der Kasse gesendeten genehmigt. Daher hat die Kasse ihn nicht verbucht, aber die Karte könnte belastet worden sein. Nehmen Sie keine weitere Zahlung entgegen. Bitten Sie eine Filialleitung, den Verkauf im Portal unter der Bestellnummer zu suchen und den vom Terminal eingezogenen Betrag mit dem Bestellbetrag zu vergleichen.
Weitere Meldungen
Zahlung fehlgeschlagen: Karte abgelehnt
Drücken Sie auf Erneut versuchen, um die Zahlung nochmals an das Terminal zu senden, oder auf Andere Zahlungsart wählen, um mit einer anderen Kachel zu bezahlen.
Das Terminal schließt noch eine vorherige Transaktion ab
Die Station ist mit einer anderen Zahlung belegt. Schließen Sie diese am Terminal ab oder brechen Sie sie dort ab. Drücken Sie anschließend auf Erneut versuchen.
Die Zahlung schlägt unmittelbar nach dem Senden fehl
Die Erweiterung wartet 30 Sekunden darauf, dass Windcave eine neue Zahlung registriert. Wenn Windcave bis dahin noch keinen Eintrag hat, behandelt die Erweiterung die Zahlung als nicht gesendet und sie schlägt fehl. Prüfen Sie, ob das Terminal eingeschaltet und online ist und seine Stations-ID in den Einstellungen steht. Drücken Sie anschließend auf Erneut versuchen.
Das Terminal stellt eine Frage, während die Kasse weiter wartet
Die Registerkarte Zahlungen zeigt die Fragen des Terminals nicht an und wartet deshalb, bis die Zahlung beendet ist. Drücken Sie auf Am Terminal abbrechen oder brechen Sie den Vorgang am Terminal ab. Nehmen Sie die Zahlung anschließend über die Registerkarte Legacy entgegen. Siehe Wenn das Terminal eine Frage stellt.
Zeitüberschreitung — Zahlung abgebrochen
Innerhalb von 5 Minuten hat niemand bezahlt. Prüfen Sie das Terminal und drücken Sie anschließend auf Erneut versuchen.
Die Kachel Windcave Terminal ist ausgegraut oder fehlt
Unter den Kacheln zeigt die Kasse den Grund an. Unter Wenn eine Kachel nicht verwendet werden kann finden Sie alle möglichen Gründe.
- Wird von Bestellung #… verwendet — die Station ist mit der Zahlung einer anderen Bestellung belegt. Schließen Sie diese Zahlung ab oder brechen Sie sie ab. Sie können auch auf Ändern drücken und eine andere Station auswählen.
- Verbindung erforderlich — die Kasse ist offline. Eine Terminalzahlung läuft über Ihre Filiale. Verwenden Sie daher eine andere Zahlungsart oder warten Sie, bis die Verbindung wiederhergestellt ist.
- Keine Kachel vorhanden — dem Zahlungsgateway fehlen HIT-Benutzername, HIT-Schlüssel oder Stations-IDs, oder es ist in WCPOS nicht aktiviert. Eine Filialleitung prüft die Einrichtung.
Windcave-Zahlung zurückerstatten
Eine Rückerstattung wird über Windcave an die Station zurückgebucht, die den Verkauf abgewickelt hat. Sie kann den gesamten Betrag oder einen Teil davon umfassen.
- Öffnen Sie im POS die Rückerstattung der Bestellung. Siehe Rückerstattungen.
- Wählen Sie An Windcave Terminal zurückerstatten und drücken Sie auf Rückerstattung verarbeiten.
- Ihre Filiale wartet bis zu 20 Sekunden auf die Antwort von Windcave und fügt das Ergebnis anschließend den Bestellnotizen hinzu.
Eine Rückerstattung in WP Admin über die WooCommerce-Schaltfläche … über Windcave Terminal zurückerstatten funktioniert genauso.
Bleibt eine Rückerstattung ausstehend, prüfen Sie sie im Windcave-Portal, bevor Sie erneut erstatten.
Eine Rückerstattung bleibt ausstehend
Windcave hat nicht innerhalb von 20 Sekunden geantwortet oder einen anderen als den angefragten Betrag genehmigt. Ihre Filiale versucht es nicht erneut. Suchen Sie die Rückerstattung im Windcave-Portal: Wurde sie ausgeführt, hat der Kunde sein Geld erhalten; andernfalls führen Sie die Rückerstattung erneut durch.
Ein Verkauf aus Version 0.1 kann nicht zurückerstattet werden
Die Rückerstattung wird mit Legen Sie in den POS-Einstellungen eine Standardstation fest, bevor Sie diesen Verkauf zurückerstatten. angehalten. Version 0.1 der Erweiterung hat nicht gespeichert, welche Station den Verkauf abgewickelt hat. Daher erstattet Version 1.0 über eine filialeinheitliche Standardstation zurück. Kassen wählen ihre Station jetzt unter Einstellungen > Kartenlesegeräte aus; WCPOS 2.0 hat noch keine filialeinheitliche Standardstation. Erstatten Sie den Verkauf im Windcave-Portal oder am Terminal und erfassen Sie die Rückerstattung anschließend mit … manuell zurückerstatten in WooCommerce.
Windcave Terminal einrichten
Eine Administratorin oder ein Administrator richtet dies einmal pro Filiale in WP Admin ein und wählt anschließend an jeder Kasse eine Station aus. Ihre Filiale erreicht jedes Terminal über Windcave und das Internet. Eine Kopplung ist daher nicht erforderlich, und jede Kasse kann jedes Ihrer Terminals verwenden.
Voraussetzungen
Sie benötigen HIT-Zugangsdaten, also einen HIT-Benutzernamen und einen HIT-Schlüssel, sowie die Stations-ID jedes Terminals. Windcave stellt all diese Daten bereit; WP Admin kann sie weder nachschlagen noch erstellen. Kontaktieren Sie Windcave und bitten Sie um UAT-Zugangsdaten für HIT sowie die Stations-ID jedes Terminals. Alternativ können Sie für ein Entwicklungskonto Windcaves Formular für Integrationsanforderungen verwenden. Für UAT und Produktion gibt es jeweils eigene Benutzernamen und Schlüssel. Sobald Windcave die Integration zertifiziert hat, stellt das Unternehmen eine Vendor-ID aus.
Erweiterung installieren
Öffnen Sie WP Admin > POS > Einstellungen > Erweiterungen, suchen Sie Windcave Terminal for WooCommerce, installieren und aktivieren Sie die Erweiterung. Sie benötigen Version 1.0 oder neuer; Version 0.1 ist für WCPOS vor Version 2.0 vorgesehen. Siehe Erweiterungen.
Sie können auch die Plugin-ZIP-Datei (nicht die ZIP-Datei mit dem Quellcode) von der GitHub-Releases-Seite unter Plugins > Add Plugin > Plugin hochladen hochladen.
Ohne WCPOS Pro 2.0 zeigt WP Admin Windcave Terminal erfordert WooCommerce POS Pro 2.0 oder neuer. an, und das Zahlungsgateway wird nicht hinzugefügt. Die Aktivierung wird bei PHP-Versionen vor 7.4 oder ohne DOM-Erweiterung abgelehnt. Bitten Sie Ihren Hosting-Anbieter, php-xml zu aktivieren.
HIT-Zugangsdaten eingeben
Gehen Sie zu WP Admin > WooCommerce > Einstellungen > Zahlungen und öffnen Sie Windcave Terminal.

- Umgebung — belassen Sie die Standardeinstellung UAT (Test). Produktion ist für die Zeit nach der Zertifizierung der Integration durch Windcave mit Produktionszugangsdaten vorgesehen.
- HIT-Benutzername — von Windcave für die ausgewählte Umgebung.
- HIT-Schlüssel — von Windcave. Nach dem Speichern bleibt das Feld leer. Lassen Sie es leer, um den gespeicherten Schlüssel beizubehalten.
- Stations-IDs — eine pro Zeile und Terminal. Windcave stellt sie bereit; sie werden nicht automatisch gefunden.
- Vendor-ID — lassen Sie das Feld leer, bis Windcave eine ID ausstellt.
- POS-Name — der Name, unter dem Ihr POS bei Windcave geführt wird. Standardmäßig
WCPOS.
Darunter ist Ergebnisbenachrichtigungen (FPRN) optional. Wenn die Option aktiviert ist, informiert Windcave Ihre Filiale zusätzlich, sobald ein Ergebnis vorliegt, als Ergänzung zu den Statusabfragen der Kasse. Damit die Funktion arbeitet, muss Ihre Website aus dem Internet erreichbar sein.
Klicken Sie auf Änderungen speichern.
In WCPOS aktivieren
Öffnen Sie WP Admin > POS > Einstellungen > Kasse, suchen Sie in der Tabelle Zahlungsgateways nach Windcave Terminal und aktivieren Sie den Schalter Aktiviert. Diese Seite speichert Änderungen automatisch; eine Schaltfläche zum Speichern gibt es nicht.
Lassen Sie Aktivieren/Deaktivieren auf der WooCommerce-Einstellungsseite ausgeschaltet. Der POS verwendet das Zahlungsgateway, sobald Aktiviert hier eingeschaltet ist, unabhängig davon, ob das andere Kontrollkästchen markiert ist. Siehe Checkout-Einstellungen.

- Windcave Terminal — die Zeile der Erweiterung in der Tabelle Zahlungsgateways.
- Aktiviert — der Schalter neben der Gateway-ID. Schalten Sie ihn ein. Nach dem Neuladen zeigt die Kasse die Kachel Windcave Terminal an.
Station für jede Kasse auswählen
Öffnen Sie an jeder Kasse Einstellungen > Kartenlesegeräte. Jede eingegebene Stations-ID wird unter Intelligente Lesegeräte als Kartenlesegerät aufgeführt und als Online markiert. Die Erweiterung fragt Windcave nicht ab, ob ein Terminal eingeschaltet ist. Drücken Sie bei der Station an dieser Kasse auf Dieses Lesegerät verwenden. In der Zeile wird Ausgewählt angezeigt. Der Kassierer kann beim Checkout weiterhin auf Ändern drücken.
Wenn es nur eine Station gibt, müssen Sie nichts auswählen: Sie ist an jeder Kasse bereits Ausgewählt. Siehe Intelligentes Lesegerät auswählen.
Überprüfen, ob alles funktioniert
- Auf der Einstellungsseite von Windcave Terminal steht unter den Einstellungen
uat: HIT credentials configured (not verified).. Das bedeutet, dass Benutzername und Schlüssel gespeichert sind, nicht dass Windcave sie akzeptiert hat.HIT credentials missing.bedeutet, dass eines der Felder leer ist. - Laden Sie den POS an einer Kasse neu und drücken Sie auf Kasse. Die Kachel Windcave Terminal wird als Zahlungsart angezeigt. Tippen Sie darauf: Oberhalb des Tastenfelds erscheinen Ihre Stations-IDs unter Terminal auswählen oder als Terminal: mit dem von dieser Kasse verwendeten Terminal.
- Führen Sie an einem UAT-Terminal einen kleinen Verkauf durch und erstatten Sie ihn anschließend zurück. Es gibt keine Schaltfläche zum Testen der Verbindung: Erst dieser Verkauf überprüft Zugangsdaten und Stations-ID.
Upgrade von Version 0.1
- Aktualisieren Sie zuerst WCPOS, WCPOS Pro und die App auf Version 2.0 und anschließend die Erweiterung.
- Eine während des Upgrades laufende Zahlung wird übernommen. Es wird nichts doppelt berechnet.
- Eine von Version 0.1 zurückgestellte Zahlung wird übernommen, wenn die zugehörige Bestellung noch unbezahlt ist. Andernfalls erhält die Bestellung den Hinweis: Windcave TxnRef … wurde vor dem Upgrade auf 1.0.0 zurückgestellt und wird nicht mehr automatisch weiterverfolgt. Prüfen Sie diese Zahlung im Windcave-Portal: Wurde sie genehmigt, erstatten Sie sie dort oder erfassen Sie sie manuell in der Bestellung.
- Diese Einstellungen aus Version 0.1 gibt es nicht mehr: Standard-Stations-ID, Terminalsuswahl sperren, Checkout-Protokolle und Protokollierungsstufe. Kassen wählen ihre Station jetzt unter Einstellungen > Kartenlesegeräte aus.
- Auch die Funktion zum Zurückstellen gibt es nicht mehr. Terminal-Belegtext wird der Bestellung nicht länger als private Notiz hinzugefügt.
- Rückerstattung eines mit Version 0.1 abgewickelten Verkaufs: siehe Windcave-Zahlung zurückerstatten.
Einstellungsreferenz
Unter WP Admin > WooCommerce > Einstellungen > Zahlungen > Windcave Terminal:
| Einstellung | Funktion |
|---|---|
| Aktivieren/Deaktivieren | Stellt das Zahlungsgateway im Checkout Ihres Onlineshops bereit. Lassen Sie die Option ausgeschaltet; der POS hat einen eigenen Schalter unter POS > Einstellungen > Kasse |
| Titel | Der Name der Kachel an der Kasse. Standardmäßig Windcave Terminal |
| Beschreibung | Standardmäßig Pay in person on the Windcave terminal. |
| Umgebung | UAT (Test) (Standard) oder Produktion. Für jede Umgebung gibt es eigene HIT-Zugangsdaten; für die Produktion ist eine Zertifizierung durch Windcave erforderlich. Eine in einer Umgebung gestartete Zahlung wird immer dort überprüft |
| HIT-Benutzername | Von Windcave für die ausgewählte Umgebung bereitgestellt |
| HIT-Schlüssel | Wird von Windcave ausgestellt. Nach dem Speichern nicht mehr sichtbar; lassen Sie das Feld leer, um den Schlüssel beizubehalten |
| Stations-IDs | Eine pro Zeile und Terminal. Duplikate werden entfernt |
| Vendor-ID | Wird während der Zertifizierung mit Windcave vereinbart. Bis dahin leer lassen |
| POS-Name | Der Name, unter dem Ihr POS bei Windcave geführt wird. Standardwert: WCPOS |
| Ergebnisbenachrichtigungen (FPRN) | Windcave informiert Ihren Shop zusätzlich, sobald ein Ergebnis vorliegt, als Ergänzung zu den Statusabfragen der Kasse. Standardmäßig ausgeschaltet |
Protokolle und Support-Paket
Am Ende der Einstellungsseite finden Sie das Support-Paket, die Zeile mit dem Status der Zugangsdaten und einen Link zu den Protokollen.

- Status der Zugangsdaten — in dieser noch nicht eingerichteten Filiale steht
HIT credentials missing.. Bei Ihnen sollteHIT credentials configured (not verified).stehen. - Protokolle anzeigen — öffnet
WooCommerce > Status > Protokolle, Quellewindcave-terminal. - Support-Paket herunterladen — eine Datei für den WCPOS-Support.
Die Protokolle enthalten jede Anfrage an Windcave und die zugehörige Antwort. HIT-Schlüssel und Kartennummern werden maskiert.
Wenn bei einer Zahlung ein Problem auftritt, klicken Sie auf Support-Paket herunterladen und senden Sie die Datei zusammen mit der Bestellnummer an den WCPOS-Support. Diese Schaltfläche wird von WCPOS Pro hinzugefügt. Das Paket umfasst alle POS-Zahlungsanbieter auf Ihrer Website; Geheimnisse und Kartennummern werden entfernt.
Was nicht unterstützt wird
- Echte Zahlungen, bis Windcave die Integration zertifiziert hat.
- Trinkgelder, Aufschläge, Bargeldauszahlungen oder eine spätere Einziehung nach der Autorisierung.
- Fragen des Terminals auf der Registerkarte Zahlungen beantworten. Verwenden Sie die Registerkarte Legacy.
- Automatische Terminalsuche: Sie geben jede Stations-ID selbst ein.
- HIT-Zugangsdaten vor der ersten Zahlung überprüfen.
Funktionsweise für Entwickler
Das Zahlungsgateway verwendet Windcave HIT (Host Initiated Transaction) über HTTPS: uat.windcave.com für UAT und sec.windcave.com für die Produktion. Jedes Terminal wird über seine Stations-ID angesprochen.
Bei einer Zahlung wird ein Purchase über den an der Kasse angegebenen Betrag gesendet. Als Händlerreferenz dienen Order # und die Bestellnummer. Anschließend prüft WCPOS Pro den Status, bis die Zahlung abgeschlossen ist. Fragt die Kasse erneut an, fragt die Erweiterung zuerst dieselbe Transaktionsreferenz ab, statt einen weiteren Purchase zu starten. Ein Purchase, den Windcave nicht innerhalb von 30 Sekunden registriert, gilt als nicht gesendet.
Wenn Ergebnisbenachrichtigungen (FPRN) aktiviert sind, fordert jeder Purchase Windcave auf, den WCPOS-Zahlungs-Webhook Ihrer Filiale aufzurufen: wp-json/wcpos/v2/payments/webhook mit provider=windcave und der Transaktionsreferenz. Dieser Aufruf dient nur als Hinweis: Anschließend fragt die Filiale das Ergebnis direkt bei Windcave ab.
Eine Rückerstattung ist ein HIT-Matched-Refund für die ursprüngliche Windcave-Transaktion über den von Ihnen eingegebenen Betrag. Die Filiale prüft den Status bis zu 20 Sekunden lang alle 2 Sekunden.
Weiterführende Dokumentation
- Kartenlesegeräte
- Die Registerkarte Legacy
- Rückerstattungen
- Checkout-Einstellungen
- Ein Problem auf GitHub melden. Bei Fragen zu Ihrem Konto, Ihren Zugangsdaten und Terminals wenden Sie sich an Windcave.