Windcave Terminal-gateway
Met de Windcave Terminal-gateway kun je kaartbetalingen op locatie accepteren via een Windcave-terminal en Windcave HIT. Betalingen worden gestart vanuit WCPOS en afgerond op de terminal, waarna de bevestiging wordt vastgelegd bij de WooCommerce-bestelling.
0.1.0 is de eerste release. Windcave vereist QA-certificering van een integratie voordat deze in productie wordt gebruikt. Deze integratie is nog niet gecertificeerd. Gebruik Windcave-UAT-inloggegevens (test) totdat de certificering is afgerond. Windcave verstrekt de Vendor ID tijdens de certificering.
Functies
Cloud-HIT-verbinding
Maak verbinding via de cloud-HIT-service van Windcave met één Station ID per terminal, zonder lokale koppeling
Terminalaanwijzingen op het scherm
Volg de aanwijzingen en knoppen van de terminal vanuit het betalingspaneel, waaronder YES/NO voor handtekeningverificatie en CANCEL
Geverifieerde afronding
Bestellingen worden pas afgerond nadat de betalingsreferentie, het bedrag, de omgeving, het bestellingstotaal en de valuta zijn gecontroleerd
Een betaling apart zetten
Zet de openstaande betaling na een time-out apart en ga verder terwijl een controle op de achtergrond de betaling opvolgt
Resultaatmeldingen
Schakel optionele resultaatmeldingen (FPRN) in, zodat Windcave je site als back-up voor polling kan informeren
Hoe het werkt
De gateway gebruikt Windcave HIT (Host Initiated Transaction) via HTTPS. Met Omgeving selecteer je het UAT- of productie-eindpunt. Elke terminal wordt aangeduid met de door Windcave verstrekte Station ID.
Wanneer je een betaling start, worden het volledige bestellingstotaal en de valuta naar de terminal gestuurd. De betaalpagina bevraagt Windcave elke 1.5 seconden, waarbij de aanwijzingen en beschikbare knoppen op de terminal worden weergegeven. Met optionele Resultaatmeldingen (FPRN) kan Windcave de site als back-up voor polling informeren.
Installatie
Windcave Terminal for WooCommerce installeren
Download het plugin-zipbestand (niet het zipbestand met de GitHub-broncode) via de GitHub-releasespagina. Upload het via Plugins > Add New > Upload Plugin en activeer het terwijl WooCommerce is geïnstalleerd en actief is.
Voor activering zijn PHP 7.4+ en de PHP DOM-extensie (php-xml) vereist. Als een van beide ontbreekt, wordt activering geweigerd met een melding.
HIT-inloggegevens opvragen bij Windcave
Vraag Windcave om een HIT-gebruikersnaam, een HIT-sleutel en één Station ID per terminal. Vraag een ontwikkelaarsaccount aan via het formulier met integratievereisten van Windcave.
UAT- en productie-inloggegevens zijn afzonderlijk. Gebruik UAT-inloggegevens zolang deze integratie op certificering wacht.
De gateway configureren
- Ga naar
WP Admin > WooCommerce > Settings > Paymentsen open Windcave Terminal - Stel Omgeving in op
UAT (testing)(de standaardinstelling).Productionis bedoeld voor gebruik met productie-inloggegevens nadat Windcave de integratie heeft gecertificeerd - Voer de door Windcave verstrekte HIT-gebruikersnaam en HIT-sleutel in
- Voer je Station IDs in, één per regel
- (Optioneel) Stel een Standaard Station ID in. Schakel Terminalselectie vergrendelen in om altijd die standaard te gebruiken en te voorkomen dat kassamedewerkers deze kunnen wijzigen
- Laat Vendor ID leeg totdat Windcave deze tijdens de certificering verstrekt
- Sla je instellingen op
Resultaatmeldingen inschakelen (optioneel)
Schakel Resultaatmeldingen (FPRN) in en sla de instellingen op, zodat Windcave je site kan informeren wanneer een transactieresultaat beschikbaar is. Dit is een back-up voor polling.
Inschakelen in WCPOS
- Ga naar
WP Admin > POS > Settings > Checkout - Zoek de gateway Windcave Terminal en schakel deze in voor de POS
- Sla je instellingen op
Het selectievakje Inschakelen/Uitschakelen op het WooCommerce-instellingenscherm bepaalt alleen het afrekenen in de onlinewinkel. WCPOS gebruikt deze gateway zodra deze is geconfigureerd, ongeacht of dit vakje is aangevinkt.
Instellingenoverzicht
| Instelling | Wat doet het? |
|---|---|
| Inschakelen/Uitschakelen | Schakelt de gateway in voor afrekenen in de onlinewinkel. Inschakelen voor de POS beheer je onder POS > Settings > Checkout |
| Titel | Het label bij het afrekenen; standaard Windcave Terminal |
| Beschrijving | De beschrijving bij het afrekenen; standaard Pay in person on the Windcave terminal. |
| Omgeving | UAT (testing) (standaard) of Production. Voor beide zijn aparte HIT-inloggegevens nodig; voor productie is Windcave-certificering vereist |
| HIT-gebruikersnaam | De HIT-gebruikersnaam die Windcave voor de geselecteerde omgeving heeft verstrekt |
| HIT-sleutel | De HIT-sleutel die Windcave voor de geselecteerde omgeving heeft verstrekt |
| Station IDs | Eén door Windcave verstrekte Station ID per regel, één voor elke terminal |
| Standaard Station ID | Het vooraf geselecteerde Station, dat ook wordt gebruikt als er geen Station is geselecteerd |
| Terminalselectie vergrendelen | Gebruikt altijd het standaard-Station, zodat kassamedewerkers dit niet kunnen wijzigen. Werkt alleen als er een standaard is ingesteld |
| Vendor ID | Wordt tijdens de certificering door Windcave verstrekt. Laat dit leeg totdat Windcave de ID verstrekt |
| POS-naam | De naam die naar Windcave wordt verzonden om de POS aan te duiden; standaard WCPOS |
| Resultaatmeldingen (FPRN) | Vraagt Windcave om de site te informeren wanneer een transactieresultaat beschikbaar is, als back-up voor polling. Standaard uitgeschakeld |
| Checkout-logs | Toont logboekhulpmiddelen in het betalingspaneel. Standaard uitgeschakeld |
| Logniveau | Off, Errors only of Debug. Standaard Debug; verzoeken en antwoorden worden geregistreerd met gemaskeerde sleutels en kaartgegevens |
| Ondersteuning | Biedt Ondersteuningsbundel downloaden en een link om logs te bekijken in WooCommerce > Status > Logs |
Er is geen knop om de verbinding te testen: inloggegevens en Station IDs worden gecontroleerd wanneer de eerste betaling wordt verwerkt.
Gebruik
Betalingen verwerken
- Artikelen toevoegen: voeg producten toe aan je winkelwagen in de POS
- Gateway selecteren: kies Windcave Terminal als betaalmethode
- Terminal kiezen: selecteer een Station of gebruik de vergrendelde standaard. Als er twee of meer Stations zijn en er geen standaard is, moet je een selectie maken
- Betaling starten: klik op Terminalbetaling starten om het bestellingstotaal naar de terminal te sturen
- Aanwijzingen volgen: de aanwijzingen en beschikbare knoppen van de terminal verschijnen op het scherm, waaronder YES/NO voor handtekeningverificatie en CANCEL wanneer die optie wordt aangeboden
- Automatisch afronden: na goedkeuring en verificatie wordt de bestelling afgerond en schakelt de POS over naar de bon
Betalingsbediening
- Terminalbetaling starten: verstuur een nieuw betalingsverzoek naar het geselecteerde Station
- Terminalbetaling annuleren: drukt op CANCEL op de terminal wanneer deze die optie aanbiedt. Annuleer anders op de terminal of zet de betaling apart wanneer die optie verschijnt
- Betaling apart zetten: verschijnt na de time-out van 5 minuten. De poging wordt overgelaten aan een controle op de achtergrond van 10 minuten, zodat je op een andere manier kunt betalen; de betaling bij Windcave wordt niet geannuleerd
- De pagina opnieuw laden: hervat een betaling die al bezig is
Bonnen
De tekst van de terminalbon wordt, wanneer Windcave deze terugstuurt, als een privébestellingsnotitie opgeslagen in WooCommerce.
Terugbetalingen
Terugbetalingen vanuit WooCommerce worden niet ondersteund in 0.1.0. Voer de terugbetaling uit in het Windcave-portaal (Payline) of op de terminal en registreer de terugbetaling vervolgens handmatig in WooCommerce.
Logs en ondersteuningsbundel
Je vindt logs in WooCommerce > Status > Logs, onder de bron windcave-terminal. Het standaardlogniveau is Debug; Windcave-verzoeken en -antwoorden worden geregistreerd met gemaskeerde sleutels en kaartgegevens.
Klik op Ondersteuningsbundel downloaden op het gateway-instellingenscherm om een .json-bestand te downloaden en stuur dit samen met het bestelnummer op. Het bestand bevat omgevingsgegevens, instellingen waarbij de HIT-sleutel en gebruikersnaam zijn gemaskeerd, betalingspogingen van maximaal 20 recente bestellingen zonder bonnen en de laatste 1,000 regels uit de twee nieuwste logbestanden. Logregels kunnen tekst van de terminalbon bevatten, waarbij kaartnummers zijn gemaskeerd.
Als WooCommerce de database-loghandler gebruikt, bevat de bundel geen logregels. Exporteer in plaats daarvan logs via WooCommerce > Status > Logs.
Schakel Checkout-logs in om logboekhulpmiddelen in het betalingspaneel weer te geven.
Vereisten
Reikwijdte en beperkingen
Deze integratie is nog niet gecertificeerd door Windcave. Gebruik UAT-inloggegevens totdat de QA-certificering door Windcave is afgerond; gebruik de integratie niet in productie voordat de certificering is voltooid.
- Terugbetalingen vanuit WooCommerce worden niet ondersteund in 0.1.0
- Fooien, toeslagen en cash-opnames worden niet ondersteund
- Alleen valuta's met twee decimalen worden ondersteund
- Op de terminal wordt het volledige bestellingstotaal in rekening gebracht; slechts een deel van een bestelling op de terminal betalen wordt niet ondersteund
- Station IDs moeten handmatig worden ingevoerd; terminals worden niet automatisch gevonden
- De gateway is ontworpen voor de POS. In de onlinewinkel werkt deze alleen op de order-pay-pagina
Probleemoplossing
Veelvoorkomende problemen
Activering geweigerd: PHP DOM-extensie (php-xml) vereist
- De PHP DOM-extensie ontbreekt op de server
- Vraag je hostingprovider om php-xml in te schakelen. Voor activering is ook PHP 7.4+ vereist
Geen Station IDs geconfigureerd
- De instelling Station IDs is leeg
- Voeg de door Windcave verstrekte Station IDs toe aan de gatewayinstellingen, één per regel, en sla ze op
Windcave HIT-inloggegevens zijn niet geconfigureerd
- De HIT-gebruikersnaam of HIT-sleutel is leeg
- Voer beide in bij de gatewayinstellingen en sla ze op. Controleer of Omgeving overeenkomt met die inloggegevens
De terminal rondt nog een eerdere transactie af
- Op dat Station wordt nog een eerdere transactie verwerkt
- Rond de transactie af of annuleer deze op de terminal en probeer het opnieuw
Windcave heeft geen gegevens van deze transactie
- Windcave heeft na de aanvankelijke wachttijd van 30 seconden nog steeds geen gegevens
- Start de betaling opnieuw
Windcave heeft een betaling goedgekeurd, maar deze kon niet worden verwerkt
- Het goedgekeurde resultaat voldeed niet aan de controles die nodig zijn om deze bestelling af te ronden
- Controleer het Windcave-portaal en de bestellingsnotities voordat je opnieuw een bedrag in rekening brengt
Deze betaling is gestart in een andere omgeving
- Omgeving is gewijzigd terwijl de betaling werd verwerkt
- Schakel terug naar de omgeving waarin de betaling is gestart of controleer het Windcave-portaal
Hulp krijgen
- Verstuur de ondersteuningsbundel vanuit het gateway-instellingenscherm samen met het bestelnummer
- Ga naar de GitHub-opslagplaats om problemen te melden
- Neem contact op met de ondersteuning van Windcave voor vragen over accounts, inloggegevens en hardware