# 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[​](#features "Directe link naar 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[​](#installation "Directe link naar 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](https://github.com/wcpos/stripe-terminal-for-woocommerce/releases) 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[​](#usage "Directe link naar Gebruik")

### Een lezer verbinden[​](#connecting-a-reader "Directe link naar 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[​](#processing-payments "Directe link naar 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[​](#testing-with-simulator "Directe link naar 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)[​](#phone-orders-moto "Directe link naar 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[​](#setup "Directe link naar Instellen")

1

#### MOTO-toegang aanvragen bij Stripe

MOTO is niet standaard ingeschakeld. Neem contact op met [Stripe support](https://support.stripe.com/contact) 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](#supported-terminals-internet-connected). De schakelaar verschijnt niet voor andere lezertypen.

#### Een telefonische bestelling opnemen[​](#taking-a-phone-order "Directe link naar Een telefonische bestelling opnemen")

1. Verbind een compatibele lezer (zie [Ondersteunde terminals](#supported-terminals-internet-connected))
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[​](#requirements "Directe link naar 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[​](#hardware-compatibility "Directe link naar 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)[​](#supported-terminals-internet-connected "Directe link naar Ondersteunde terminals (internetverbonden)")

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

### Niet-ondersteunde terminals (Bluetooth)[​](#unsupported-terminals-bluetooth "Directe link naar 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[​](#common-issues "Directe link naar Veelvoorkomende problemen")

Lezer maakt geen verbinding

* Zorg dat je een [ondersteunde internetverbonden terminal](#supported-terminals-internet-connected) 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](#supported-terminals-internet-connected)) — 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](https://support.stripe.com/contact) 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[​](#getting-help "Directe link naar Hulp krijgen")

Voor technische ondersteuning:

* Bezoek de [GitHub-repository](https://github.com/wcpos/stripe-terminal-for-woocommerce) om problemen te melden
* Raadpleeg de [Stripe Terminal-documentatie](https://stripe.com/docs/terminal) voor hardware-specifieke begeleiding
* Neem contact op met Stripe support voor accountgerelateerde problemen

## Schermafbeeldingen[​](#screenshots "Directe link naar 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
