Windcave Terminal-betaalgateway
Windcave Terminal stuurt een verkoop vanaf de kassa naar een Windcave-terminal. De klant betaalt op de terminal en de kassa registreert de betaling zodra Windcave deze bevestigt.
Deze pagina begint bij de kassa. Winkelbeheerders vinden bij Windcave Terminal instellen de toegangsgegevens, de instellingen in WP Admin en hoe je controleert of alles werkt.
Voor Windcave Terminal heb je WCPOS Pro 2.0 of hoger en versie 1.0 of hoger van de extensie nodig.
Alleen testbetalingen: accepteer voorlopig geen echte kaarten van klanten via Windcave. Windcave keurt elke POS-integratie goed voordat deze echte betalingen kan verwerken, en deze integratie is nog niet goedgekeurd. De extensie is nog niet getest op een fysieke Windcave-terminal. Betalingen en terugbetalingen zijn getest met een testimplementatie van de HIT-service van Windcave, gebouwd op basis van de documentatie van Windcave. Voer een kleine UAT-verkoop uit en betaal deze terug voordat je erop vertrouwt.Wat nog niet is getest
Een kaartbetaling ontvangen
Als De kassa openen en sluiten is ingeschakeld, registreert de kassa geen betaling wanneer de kassa gesloten is. Een kaartbetaling die je al hebt ontvangen, moet je dan terugbetalen. Zie Kassa's voor deze instelling.
- Druk in de winkelwagen op Afrekenen en tik op de tegel Windcave Terminal op het tabblad Betalingen. Als je terminals om een handtekening vragen, gebruik dan het tabblad Verouderd: zie Wanneer de terminal een vraag stelt.
- Kijk boven het toetsenblok. Zie je Kies een terminal, tik dan op de Station-ID van de terminal bij je kassa: de naam die Windcave aan elke terminal geeft, bijvoorbeeld
DOCS-STATION-1. Zie je Terminal: met een ID, dan gebruikt deze kassa die terminal; druk op Wijzigen om een andere te kiezen. De kassa onthoudt je keuze. - Typ het bedrag om een deel van het verschuldigde saldo op de kaart te innen. De rest blijft openstaan voor een volgende betaling.
- Druk op Verstuur … naar Windcave Terminal. De kassa toont Op de terminal met vier stappen: Verzonden, Op terminal, Goedgekeurd en Verwerkt; dat betekent dat het geld is geïnd.
- De klant tikt de kaart tegen de terminal, steekt deze erin of haalt hem erdoorheen. Zodra de betaling is verwerkt en er niets meer openstaat, wordt de bon geopend. Staat er nog een bedrag open, int dat dan met een andere tegel.

- Windcave Terminal — de tegel, die na het aantikken een omlijning krijgt.
- Station-ID's onder Kies een terminal — tik op de terminal bij je kassa. Zodra deze kassa er een heeft, toont deze rij Terminal: met de ID en Wijzigen.
- Te betalen — het bedrag van deze betaling. Typ een lager bedrag om een deel van het saldo op de kaart te innen.
- Volledig saldo — zet het volledige nog openstaande bedrag terug bij Te betalen.
- Verstuur … naar Windcave Terminal — start de betaling op de terminal. De knop is gedimd totdat een terminal is gekozen.
- Verouderd — het andere betalingstabblad, voor betaalgateways met een eigen betaalpagina. Gebruik dit wanneer je terminal om een handtekening vraagt.
Details onder de vier stappen opent een logboek van de betaling, met het station waarnaar deze is gestuurd. De terminal ondersteunt geen fooi, toeslag of contant geld opnemen.
Wanneer de terminal een vraag stelt
Een terminal kan stoppen om iets te vragen, bijvoorbeeld of de handtekening van de klant overeenkomt. In deze versie toont het tabblad Betalingen die vragen niet. Het tabblad Verouderd doet dat wel:
- Open het tabblad Verouderd en kies Windcave Terminal. Zie Het tabblad Verouderd.
- Start daar de betaling. De volledige bestelling wordt in één betaling afgerekend.
- Wanneer de terminal iets vraagt, toont de betaalpagina de vraag met de eigen knoppen van de terminal, zoals JA en NEE. Druk op het antwoord.
Een betaling annuleren
Druk op Annuleren op terminal voordat de klant betaalt. Dit werkt alleen zolang de terminal zelf ANNULEREN aanbiedt. Zo niet, dan toont de kassa De terminal biedt momenteel geen annuleermogelijkheid. Annuleer op de terminal.
Annuleren is een verzoek. Als de kaart al is gelezen, kan de betaling alsnog worden verwerkt: de kassa toont Annuleren — wachten op bevestiging van de terminal, blijft controleren en toont het resultaat. Wacht hierop voordat je op een andere manier een betaling ontvangt.
Als de kassa geen antwoord krijgt, biedt deze Deze betaling vrijgeven aan. Vrijgeven betekent niet dat de betaling is geannuleerd: doe dit pas nadat een beheerder in het Windcave-portaal heeft gecontroleerd dat er geen goedgekeurde betaling voor de bestelling is. Daarna kan de bestelling op een andere manier worden betaald; de winkel blijft de terminal controleren.
Als er iets misgaat
Wanneer de klant mogelijk al heeft betaald
In deze twee gevallen kan de kaart al zijn belast. Een beheerder controleert eerst het Windcave-portaal, waar de verkoop onder het bestelnummer staat.
Kan het terminalresultaat niet bevestigen. Controleer Windcave voordat je de betaling opnieuw ontvangt. De kassa heeft opnieuw gevraagd naar een betaling die al was verstuurd, maar het antwoord van Windcave was onduidelijk. Ontvang de betaling pas opnieuw nadat een beheerder de verkoop in het portaal heeft opgezocht en niet heeft gevonden.
Betaling mislukt: de terminal heeft een ander bedrag bevestigd. De terminal heeft een ander bedrag goedgekeurd dan de kassa had verstuurd. De kassa heeft de betaling daarom niet geregistreerd, maar de kaart kan wel zijn belast. Ontvang geen nieuwe betaling: vraag een beheerder de verkoop in het portaal op bestelnummer op te zoeken en het geïnde bedrag met de bestelling te vergelijken.
Andere meldingen
Betaling mislukt: kaart geweigerd
Druk op Opnieuw proberen om de betaling opnieuw naar de terminal te sturen, of op Andere manier kiezen om met een andere tegel te betalen.
De terminal rondt nog een eerdere transactie af
Het station is bezig met een andere betaling. Rond deze af of annuleer deze op de terminal en druk daarna op Opnieuw proberen.
De betaling mislukt meteen nadat deze is verstuurd
De extensie wacht 30 seconden totdat Windcave een nieuwe betaling registreert. Als Windcave deze dan nog niet heeft geregistreerd, beschouwt de extensie de betaling als niet verzonden en mislukt deze. Controleer of de terminal is ingeschakeld en online is en of de Station-ID in de instellingen staat. Druk daarna op Opnieuw proberen.
De terminal stelt een vraag en de kassa blijft wachten
Het tabblad Betalingen toont de vragen van de terminal niet en wacht daarom totdat de betaling is beëindigd. Druk op Annuleren op terminal of annuleer op de terminal en ontvang de betaling daarna via het tabblad Verouderd. Zie Wanneer de terminal een vraag stelt.
Time-out — betaling geannuleerd
Er heeft binnen 5 minuten niemand betaald. Controleer de terminal en druk daarna op Opnieuw proberen.
De tegel Windcave Terminal is grijs of ontbreekt
Onder de tegels geeft de kassa de reden aan. Zie Wanneer een tegel niet kan worden gebruikt voor alle mogelijke redenen.
- In gebruik voor bestelling #… — het station is bezig met een betaling voor een andere bestelling. Rond die betaling af of annuleer deze, of druk op Wijzigen en kies een ander station.
- Verbinding vereist — de kassa is offline. Een terminalbetaling loopt via je winkel. Ontvang een ander type betaling of wacht tot de verbinding is hersteld.
- Helemaal geen tegel — de betaalgateway mist de HIT-gebruikersnaam, HIT-sleutel of Station-ID's, of is niet ingeschakeld in WCPOS. Een beheerder controleert de instellingen.
Een Windcave-betaling terugbetalen
Een terugbetaling verloopt via Windcave naar het station dat de verkoop heeft verwerkt, voor het volledige bedrag of een deel daarvan.
- Open in de POS de terugbetaling van de bestelling. Zie Terugbetalingen.
- Kies Terugbetalen via Windcave Terminal en druk op Terugbetaling verwerken.
- Je winkel wacht maximaal 20 seconden op antwoord van Windcave en voegt het resultaat daarna toe aan de bestelnotities.
Een terugbetaling in WP Admin met de knop Terugbetalen … via Windcave Terminal van WooCommerce werkt hetzelfde.
Als een terugbetaling in behandeling blijft, controleer deze dan in het Windcave-portaal voordat je opnieuw terugbetaalt.
Een terugbetaling blijft in behandeling
Windcave heeft niet binnen 20 seconden geantwoord of heeft een ander bedrag goedgekeurd dan was aangevraagd. Je winkel probeert het niet opnieuw. Zoek de terugbetaling op in het Windcave-portaal: als deze is verwerkt, heeft de klant het geld terug; zo niet, voer de terugbetaling dan opnieuw uit.
Een verkoop uit versie 0.1 kan niet worden terugbetaald
De terugbetaling stopt met de melding Configureer een standaardstation in de POS-instellingen voordat je deze verkoop terugbetaalt. Versie 0.1 van de extensie legde niet vast welk station de verkoop had verwerkt. Daarom voert versie 1.0 terugbetalingen uit via een standaardstation voor de hele winkel. Kassa's kiezen nu hun eigen station onder Instellingen > Kaartlezers; WCPOS 2.0 heeft nog geen standaardstation voor de hele winkel. Betaal de verkoop terug via het Windcave-portaal of op de terminal en registreer de terugbetaling daarna in WooCommerce met Handmatig terugbetalen.
Windcave Terminal instellen
Een beheerder doet dit eenmaal per winkel in WP Admin en kiest daarna op elke kassa een station. Je winkel bereikt elke terminal via Windcave en het internet. Koppelen is dus niet nodig en elke kassa kan elke terminal gebruiken.
Vereisten
Je hebt HIT-toegangsgegevens nodig: een HIT-gebruikersnaam, een HIT-sleutel en de Station-ID van elke terminal. Windcave verstrekt deze; WP Admin kan ze niet opzoeken of aanmaken. Neem contact op met Windcave en vraag om UAT-HIT-toegangsgegevens en de Station-ID van elke terminal, of gebruik het formulier voor integratievereisten van Windcave voor een ontwikkelaarsaccount. UAT en productie hebben elk een eigen gebruikersnaam en sleutel. Zodra Windcave de integratie certificeert, verstrekt Windcave een Vendor-ID.
De extensie installeren
Open WP Admin > POS > Settings > Extensions, zoek Windcave Terminal for WooCommerce, installeer en activeer deze. Je hebt versie 1.0 of hoger nodig; versie 0.1 is bedoeld voor WCPOS ouder dan 2.0. Zie Extensies.
Je kunt ook het plugin-zipbestand (niet het zipbestand met de broncode) uploaden vanaf de GitHub-releasepagina, via Plugins > Add Plugin > Upload Plugin.
Zonder WCPOS Pro 2.0 toont WP Admin Windcave Terminal vereist WooCommerce POS Pro 2.0 of hoger. en wordt de betaalgateway niet toegevoegd. Activering wordt geweigerd bij PHP ouder dan 7.4 of zonder de DOM-extensie: vraag je hostingprovider om php-xml in te schakelen.
Je HIT-toegangsgegevens invoeren
Ga naar WP Admin > WooCommerce > Settings > Payments en open Windcave Terminal.

- Omgeving — laat deze op UAT (testen) staan, de standaardinstelling. Productie is bedoeld voor nadat Windcave de integratie heeft gecertificeerd, met productiegegevens.
- HIT-gebruikersnaam — afkomstig van Windcave, voor de gekozen omgeving.
- HIT-sleutel — afkomstig van Windcave. Na het opslaan blijft het veld leeg: laat het leeg om de opgeslagen sleutel te behouden.
- Station-ID's — één per regel, één voor elke terminal. Windcave verstrekt ze; ze worden niet automatisch gevonden.
- Vendor-ID — laat dit leeg totdat Windcave er een verstrekt.
- POS-naam — de naam waaronder je POS bij Windcave bekend is. Standaard
WCPOS.
Daaronder is Resultaatmeldingen (FPRN) optioneel. Als deze optie is aangevinkt, laat Windcave je winkel ook weten wanneer een resultaat beschikbaar is, als aanvulling op de controles van de kassa. Je site moet via internet bereikbaar zijn om dit te laten werken.
Klik op Wijzigingen opslaan.
Inschakelen in WCPOS
Ga naar WP Admin > POS > Settings > Checkout, zoek Windcave Terminal in de tabel Betaalgateways en schakel Ingeschakeld in. Dit scherm slaat wijzigingen automatisch op; er is geen knop Opslaan.
Laat Inschakelen/uitschakelen op de WooCommerce-instellingenpagina uitgeschakeld. De POS gebruikt de betaalgateway zodra Ingeschakeld hier aanstaat, ongeacht of dat vakje is aangevinkt. Zie Afrekeninstellingen.

- Windcave Terminal — de rij van de extensie in de tabel Betaalgateways.
- Ingeschakeld — de schakelaar naast de ID van de betaalgateway; schakel deze in. Na het opnieuw laden toont de kassa de tegel Windcave Terminal.
Het station van elke kassa kiezen
Open op elke kassa Instellingen > Kaartlezers. Elke ingevoerde Station-ID staat onder Slimme lezers vermeld als lezer en is gemarkeerd als Online: de extensie vraagt Windcave niet of een terminal is ingeschakeld. Druk bij het station van die kassa op Deze lezer gebruiken; de rij krijgt de status Geselecteerd. De kassamedewerker kan bij het afrekenen nog steeds op Wijzigen drukken.
Als er maar één station is, hoef je niets te kiezen: dit is op elke kassa al Geselecteerd. Zie Een slimme lezer kiezen.
Controleren of alles werkt
- Ga terug naar de instellingenpagina van Windcave Terminal. Onder de instellingen staat
uat: HIT credentials configured (not verified).Dit betekent dat de gebruikersnaam en sleutel zijn opgeslagen, niet dat Windcave ze heeft geaccepteerd.HIT credentials missing.betekent dat een van beide ontbreekt. - Laad de POS opnieuw op een kassa en druk op Afrekenen. De tegel Windcave Terminal staat bij de betaalmethoden. Tik erop: je Station-ID's verschijnen boven het toetsenblok, onder Kies een terminal of als Terminal: met de terminal die deze kassa gebruikt.
- Voer een kleine verkoop uit op een UAT-terminal en betaal deze daarna terug. Er is geen knop om de verbinding te testen: deze eerste verkoop controleert de toegangsgegevens en de Station-ID.
Upgraden vanaf versie 0.1
- Werk eerst WCPOS, WCPOS Pro en de app bij naar 2.0 en werk daarna de extensie bij.
- Een betaling die tijdens de upgrade bezig is, wordt meegenomen. Er wordt niets twee keer in rekening gebracht.
- Een betaling die versie 0.1 opzij heeft gezet, wordt meegenomen als de bestelling nog niet is betaald. Anders krijgt de bestelling deze notitie: Windcave TxnRef … is vóór de upgrade naar 1.0.0 opzijgezet en wordt niet langer automatisch gevolgd. Controleer die betaling in het Windcave-portaal: als deze is goedgekeurd, betaal je deze daar terug of registreer je dit handmatig bij de bestelling.
- Deze instellingen uit versie 0.1 zijn verdwenen: Standaard Station-ID, Terminalkeuze vergrendelen, Afrekenlogboeken en Logniveau. Kassa's kiezen hun station nu onder Instellingen > Kaartlezers.
- Ook de functie Opzijzetten is verdwenen. Bontekst van de terminal wordt niet meer als privénotitie aan de bestelling toegevoegd.
- Een verkoop uit versie 0.1 terugbetalen: zie Een Windcave-betaling terugbetalen.
Overzicht van instellingen
Ga naar WP Admin > WooCommerce > Settings > Payments > Windcave Terminal:
| Instelling | Functie |
|---|---|
| Inschakelen/uitschakelen | Biedt de betaalgateway aan bij het afrekenen in je webwinkel. Laat dit uitgeschakeld; de POS heeft een eigen schakelaar onder POS > Settings > Checkout |
| Titel | De naam van de tegel bij de kassa. Standaard Windcave Terminal |
| Beschrijving | Standaard Pay in person on the Windcave terminal. |
| Omgeving | UAT (testen) (standaard) of Productie. Elke omgeving heeft eigen HIT-toegangsgegevens; voor productie is Windcave-certificering vereist. Een betaling die in een omgeving is gestart, wordt altijd in diezelfde omgeving gecontroleerd |
| HIT-gebruikersnaam | Verstrekt door Windcave, voor de gekozen omgeving |
| HIT-sleutel | Verstrekt door Windcave. Na het opslaan wordt deze nooit meer getoond; laat het veld leeg om de sleutel te behouden |
| Station-ID's | Eén per regel, één per terminal. Dubbele waarden worden verwijderd |
| Vendor-ID | Wordt tijdens de certificering met Windcave afgesproken. Laat dit tot die tijd leeg |
| POS-naam | De naam waaronder je POS bij Windcave bekend is. Standaard WCPOS |
| Resultaatmeldingen (FPRN) | Windcave laat je winkel ook weten wanneer er een resultaat beschikbaar is, als aanvulling op de controles van de kassa. Standaard uitgeschakeld |
Logs en ondersteuningsbundel
Onderaan de instellingenpagina staan de ondersteuningsbundel, de regel met toegangsgegevens en een link naar de logboeken.

- Regel met toegangsgegevens — op deze winkel, die nog niet is ingesteld, staat
HIT credentials missing.Bij jou hoortHIT credentials configured (not verified).te staan. - Logboeken bekijken — opent
WooCommerce > Status > Logs, bronwindcave-terminal. - Ondersteuningsbundel downloaden — een bestand voor WCPOS-ondersteuning.
De logboeken registreren elk verzoek aan Windcave en het antwoord daarop. De HIT-sleutel en kaartnummers worden afgeschermd.
Gaat er iets mis met een betaling, klik dan op Ondersteuningsbundel downloaden en stuur het bestand samen met het bestelnummer naar WCPOS-ondersteuning. Deze knop is toegevoegd door WCPOS Pro. De bundel bevat gegevens over elke POS-betaalprovider op je site, zonder geheimen en kaartnummers.
Wat niet wordt ondersteund
- Echte betalingen, totdat Windcave de integratie certificeert.
- Fooien, toeslagen, contant geld opnemen of nu autoriseren en later verwerken.
- De vragen van de terminal beantwoorden op het tabblad Betalingen. Gebruik het tabblad Verouderd.
- Terminals automatisch vinden: je voert elke Station-ID zelf in.
- De HIT-toegangsgegevens controleren voordat de eerste betaling wordt uitgevoerd.
Zo werkt het, voor ontwikkelaars
De betaalgateway gebruikt Windcave HIT (Host Initiated Transaction) via HTTPS: uat.windcave.com voor UAT en sec.windcave.com voor productie. Elke terminal wordt aangeduid met de Station-ID.
Een betaling verstuurt een Purchase voor het bedrag op de kassa, met Order # en het bestelnummer als referentie voor de verkoper. Vervolgens controleert WCPOS Pro de status totdat de betaling is afgerond. Als de kassa opnieuw vraagt, raadpleegt de extensie eerst dezelfde transactiereferentie in plaats van een nieuwe Purchase te starten. Als Windcave een Purchase niet binnen 30 seconden registreert, geldt deze als niet verzonden.
Als Resultaatmeldingen (FPRN) is ingeschakeld, vraagt elke Purchase Windcave om je winkel aan te roepen via de WCPOS-betalingswebhook wp-json/wcpos/v2/payments/webhook, met provider=windcave en de transactiereferentie. Dit verzoek is alleen een aanwijzing: de winkel vraagt Windcave vervolgens zelf om het resultaat.
Een terugbetaling is een HIT matched Refund tegen de oorspronkelijke Windcave-transactie, voor het bedrag dat je invoert. De winkel controleert de status elke 2 seconden, maximaal 20 seconden lang.
Gerelateerde documentatie
- Kaartlezers
- Het tabblad Verouderd
- Terugbetalingen
- Kassa-instellingen
- Meld een probleem op GitHub. Neem voor je account, toegangsgegevens en terminals contact op met Windcave.