Ga naar de hoofdinhoud
Versie: 1.x

Stripe Terminal Gateway

Met de Stripe Terminal-gateway kun je rechtstreeks binnen WCPOS persoonlijke betalingen accepteren met Stripe Terminal-hardwarekaartlezers. Deze gateway ondersteunt zowel fysieke kaartlezers als de simulatormodus voor testen.

Functies​

Hardware-integratie

Verbind fysieke Stripe Terminal-lezers via een internetverbinding

Simulatormodus

Test betalingen zonder hardware met de simulator van Stripe

Realtime verwerking

Directe verwerking en bevestiging van betalingen

Veilige transacties

PCI-conforme betalingsverwerking via Stripe

Telefonische bestellingen (MOTO)

Accepteer kaartbetalingen via de telefoon door de gegevens in de lezer in te toetsen

Installatie​

1

Installeer Stripe Terminal for WooCommerce

Installeer via WP Admin > POS > Settings > Extensions, of download de nieuwste plugin-zip-asset (niet de GitHub broncode-zip of tarball) van de GitHub releases-pagina en upload deze via Plugins > Add New > Upload Plugin.

2

Stripe-instellingen configureren

  1. Ga naar WP Admin > WooCommerce > Settings > Payments
  2. Zoek Stripe Terminal in de lijst met betaalmethoden
  3. Klik op Stripe Terminal om de instellingen te openen
  4. Voer je Stripe Secret Key in (deze vind je in je Stripe Dashboard)
  5. Sla de instellingen op
opmerking

Je hoeft de Stripe Terminal-gateway niet in te schakelen in de WooCommerce-instellingen. Deze wordt in de volgende stap specifiek voor de POS ingeschakeld.

3

Inschakelen in WCPOS

  1. Ga naar WP Admin > POS > Settings > Checkout
  2. Zoek de Stripe Terminal-gateway in de lijst
  3. Schakel de gateway in voor gebruik in de POS
  4. Sla je instellingen op

Gebruik​

Een lezer verbinden​

Wanneer je tijdens het afrekenen in de POS de Stripe Terminal-gateway selecteert:

  1. Kies verbindingsmethode: Je kunt een fysieke lezer verbinden of de simulator gebruiken
  2. Fysieke lezer: Volg de instructies op het scherm om je Stripe Terminal-apparaat te verbinden
  3. Simulator: Selecteer de simulatormodus om verschillende betaalscenario's te testen zonder hardware

Betalingen verwerken​

  1. Artikelen toevoegen: Voeg producten toe aan je winkelwagen in de POS
  2. Gateway selecteren: Kies "Stripe Terminal" als betaalmethode
  3. Lezer verbinden: Verbind je lezer of kies de simulatormodus
  4. Betaling verwerken: Volg de aanwijzingen om de transactie te voltooien
  5. Bevestiging: De bestelling wordt automatisch voltooid na een geslaagde betaling

Testen met de simulator​

Met de simulator kun je verschillende betaalmethoden en scenario's testen:

  • Kaartbetalingen: Test verschillende kaarttypen (Visa, Mastercard, enz.)
  • Contactloze betalingen: Simuleer tap-to-pay-transacties
  • Foutscenario's: Test geweigerde betalingen en andere foutsituaties
  • Verschillende bedragen: Test diverse transactiebedragen

Telefonische bestellingen (MOTO)​

Met MOTO (Mail Order/Telephone Order) kun je kaartbetalingen verwerken voor klanten die niet fysiek aanwezig zijn — bijvoorbeeld wanneer je een bestelling telefonisch opneemt. In plaats van een kaart te tikken of in te steken, toetst de verkoper de kaartgegevens rechtstreeks in op het scherm van de terminallezer.

Instellen​

1

MOTO-toegang aanvragen bij Stripe

MOTO is niet standaard ingeschakeld. Neem contact op met Stripe support en vraag of ze MOTO-rechten voor je account willen inschakelen. Dit is een snel proces, maar vereist handmatige goedkeuring van Stripe.

2

Inschakelen in de plugin-instellingen

  1. Ga naar WP Admin > WooCommerce > Settings > Payments > Stripe Terminal
  2. Vink het selectievakje Phone Orders (MOTO) aan
  3. Sla de instellingen op
3

Een compatibele lezer verbinden

MOTO werkt alleen met compatibele, internetverbonden lezers die staan vermeld bij Ondersteunde terminals. De schakelaar verschijnt niet voor andere lezertypen.

Een telefonische bestelling opnemen​

  1. Verbind een compatibele lezer (zie Ondersteunde terminals)
  2. Zet op het betaalscherm Phone Order aan
  3. Klik op Collect Card Payment — de lezer toont een invoerscherm voor het kaartnummer in plaats van te vragen om te tikken/insteken
  4. Toets het kaartnummer, de vervaldatum en de CVV van de klant in op de lezer
  5. De betaling wordt vanaf dat punt normaal verwerkt
tip

MOTO-betalingen gebruiken card als type betaalmethode in plaats van card_present. Dit betekent dat ze vanuit het perspectief van Stripe meer als online transacties worden behandeld, zodat de standaardkosten voor online kaartverwerking gelden in plaats van de tarieven voor persoonlijke betalingen.

let op

De schakelaar Phone Order verschijnt alleen wanneer aan alle drie de voorwaarden is voldaan: de MOTO-instelling is ingeschakeld in de plugin-instellingen, er is een compatibele lezer verbonden en de lezer is geen simulator. Zie je de schakelaar niet, controleer dan deze voorwaarden.

Vereisten​

Stripe-account: Actief Stripe-account met Terminal ingeschakeld
API-sleutels: Stripe secret key uit je dashboard
WCPOS: Pro-versie vereist voor POS-afrekenen
HTTPS: Je site moet SSL/HTTPS gebruiken voor de beveiliging

Hardwarecompatibiliteit​

Connectiviteitsvereisten

Deze implementatie maakt gebruik van de JavaScript SDK van Stripe, wat betekent dat het werkt via webapplicaties, maar alleen internetverbonden terminals vereist. Bluetooth-terminals worden momenteel niet ondersteund.

Ondersteunde terminals (internetverbonden)​

  • Stripe Reader S700/S710 ✅ - Terminal met ethernet-/WiFi-verbinding
  • WisePOS E ✅ - Terminal met WiFi-verbinding

Niet-ondersteunde terminals (Bluetooth)​

  • BBPOS Chipper 2X BT ❌ - Alleen Bluetooth
  • BBPOS WisePad 3 ❌ - Alleen Bluetooth
  • Verifone P400 ❌ - Alleen Bluetooth
Toekomstige ondersteuning

Ondersteuning voor Bluetooth-terminals staat gepland voor een toekomstige release van de iOS- en Android-app. Wanneer dit beschikbaar is, maakt dit ondersteuning mogelijk voor alle door Stripe Terminal gecertificeerde lezers, waaronder de M2 en WisePad 3.

Veelvoorkomende problemen​

Lezer maakt geen verbinding
  • Zorg dat je een ondersteunde internetverbonden terminal gebruikt
  • Controleer of de terminal verbonden is met WiFi/ethernet en online is
  • Controleer of Terminal is ingeschakeld voor je Stripe-account
  • Bevestig dat de terminal is geregistreerd in je Stripe Dashboard
Betaling geweigerd
  • Controleer of je Stripe-account actief is en in goede staat verkeert
  • Controleer of de gebruikte kaart geldig is
  • Zorg dat er voldoende saldo beschikbaar is
Schakelaar Phone Order verschijnt niet
  • Controleer of de instelling Phone Orders (MOTO) is ingeschakeld in WooCommerce > Settings > Payments > Stripe Terminal
  • Zorg dat je verbonden bent met een compatibele lezer (zie Ondersteunde terminals) — de schakelaar is verborgen voor andere lezertypen
  • De schakelaar verschijnt niet wanneer je de simulator gebruikt
MOTO-betaling mislukt met een fout
  • Bevestig dat Stripe MOTO-rechten heeft ingeschakeld voor je account — neem contact op met Stripe support als je dat nog niet hebt gedaan
  • Controleer nogmaals of de kaartgegevens correct op de lezer zijn ingevoerd
  • MOTO-betalingen kunnen strengere fraudecontroles hebben — zorg dat de kaart geldig is en voldoende saldo heeft
Fouten met SSL-certificaten
  • Stripe Terminal vereist HTTPS - zorg dat je site een geldig SSL-certificaat heeft
  • Controleer of je SSL-certificaat correct is geconfigureerd

Hulp krijgen​

Voor technische ondersteuning:

Schermafbeeldingen​

Schermafbeeldingen worden in een toekomstige update toegevoegd om het volgende te tonen:

  • Gateway-configuratie in de WooCommerce-betaalinstellingen
  • POS-afrekeninterface met selectie van Stripe Terminal
  • Simulator-testinterface met verschillende betaalmethoden