Stripe Terminal-betaalgateway
Met Stripe Terminal gebruik je een Stripe-kaartlezer aan je kassa. De kassa stuurt het bedrag naar de lezer en de klant houdt de kaart tegen de lezer, steekt deze erin of haalt deze erdoorheen. De verkoop wordt afgerond zodra Stripe de betaling heeft geïnd en er niets meer te betalen is. Op deze pagina lees je hoe je dit eenmalig instelt, op elke kassa een lezer verbindt en de eerste betaling ontvangt.
Alles al ingesteld? Verbind een lezer op deze kassa of ontvang een betaling.
Stripe Terminal vereist WCPOS Pro 2.0.0 of nieuwer. Zonder WCPOS Pro werkt de extensie niet.
Kies je lezers
Stripe verkoopt drie soorten lezers. Welke lezer een kassa kan gebruiken, hangt af van het apparaat waarop de POS draait.
- Slimme lezer — werkt op elke kassa: in de browser, de desktopapp, op iPhone, iPad en Android. Stripe Reader S700 en S710, BBPOS WisePOS E. De lezer is verbonden met je netwerk en je winkel stuurt de betaling ernaartoe.
- Bluetooth-lezer — alleen in de iOS- en Android-apps. Stripe Reader M2, BBPOS WisePad 3. De lezer wordt gekoppeld aan de telefoon of tablet.
- Tap to Pay — komt via een app-update naar de iOS- en Android-apps. Geen lezer nodig: de klant houdt de kaart tegen de telefoon zelf.
Een browser of de desktopapp heeft geen toegang tot een Bluetooth-lezer of de contactloze chip van een telefoon. Daarom gebruiken deze kassa's een slimme lezer. Koop lezers in de Terminal-shop in je Stripe-dashboard.
Stripe verkoopt de Stripe Reader M2 in de Verenigde Staten en de BBPOS WisePad 3 daarbuiten, in het Verenigd Koninkrijk, Europa, Canada, Australië en andere landen. Kijk in de Terminal-shop welke lezer voor jou beschikbaar is.
De betaalgateway instellen
Een beheerder doet dit eenmalig per winkel, in WP Admin.
- Installeer de extensie. Download het zipbestand van de plugin,
stripe-terminal-for-woocommerce.zip, uit de releasebestanden op GitHub en upload het viaPlugins > Add Pluginen vervolgens Plugin uploaden. Het zipbestand "Source code" van GitHub kun je niet installeren. - Voeg je sleutels toe. Ga naar
WP Admin > WooCommerce > Settings > Payments, open Stripe Terminal en plak je Geheime live-sleutel en, als je het eerst wilt uitproberen, ook je Geheime testsleutel. Beide vind je in je Stripe-dashboard. Na het opslaan verschijnt een sleutel als stippen met (opgeslagen; laat leeg om te behouden). - Kies een Terminal-locatie voor Bluetooth-lezers en Tap to Pay. Maak in het Stripe-dashboard onder Terminal → Locaties een locatie aan in testmodus en een in livemodus. Selecteer ze vervolgens bij Terminal-locatie (test) en Terminal-locatie (live).
- Vink de lezers aan die deze winkel toestaat onder POS-verbindingen: Slimme lezers, Bluetooth-lezers en Tap to Pay, of beide. Wil je Bluetooth-lezers of Tap to Pay in de apps gebruiken, vink dan Bluetooth-lezers en Tap to Pay aan en vink Slimme lezers uit. Zie Slimme lezers, Bluetooth of beide.
- Sla de instellingen op en controleer of op de webhookregel eronder Ondertekeningsgeheim opgeslagen. staat.
- Schakel de betaalgateway in voor de POS. Ga naar
WP Admin > POS > Settings > Checkout, schakel Stripe Terminal in en sla op. Je hoeft de betaalgateway niet in te schakelen in de eigen betaallijst van WooCommerce; zie Kassa-instellingen.
Zonder locatie kan een Bluetooth-lezer of Tap to Pay geen verbinding maken en toont de kassa Selecteer een Terminal-locatie in de Stripe Terminal-instellingen voordat je een mobiele lezer verbindt.
Alle instellingen op de pagina van de betaalgateway
- Titel en Beschrijving — de naam en de tekst die klanten zien. De kassa toont de titel op de tegel.
- Geheime live-sleutel en Geheime testsleutel — uit het Stripe-dashboard.
- Standaardterminal — de slimme lezer die een kassa voor betalingen gebruikt totdat er een andere wordt gekozen.
- Ingeschakelde terminals — beperkt kassa's tot de slimme lezers die je selecteert. Laat dit leeg om alle lezers van het account toe te staan.
- Terminalselectie vergrendelen — Kassamedewerkers kunnen de terminal niet wijzigen bij het afrekenen in de POS. Vereist een Standaardterminal.
- POS-verbindingen — welke soorten lezers kassa's mogen gebruiken: Slimme lezers (de winkel stuurt de lezer aan via het netwerk) en Bluetooth-lezers en Tap to Pay (de POS-app stuurt de lezer aan). Zie Slimme lezers, Bluetooth of beide.
- Terminal-locatie (test) en Terminal-locatie (live) — waar Bluetooth-lezers en Tap to Pay worden geregistreerd wanneer de app ze verbindt.
- Testmodus — Testmodus inschakelen. Een site zonder HTTPS blijft in testmodus: Stripe Terminal heeft HTTPS nodig voor livebetalingen.
- Telefonische bestellingen (MOTO) — Schakel betalingen voor telefonische bestellingen via Stripe Terminal in. Zie Telefonische bestellingen (MOTO).
- Lezer actief houden (experimenteel) — pingt de lezer zodat de eerste betaling na een rustige periode niet traag verloopt. Niet aanbevolen wanneer meerdere kassa's één lezer delen.
Onder de velden toont de pagina je Stripe Terminal-locaties en de webhookregel.
Slimme lezers, Bluetooth of beide
POS-verbindingen is een winkelinstelling: deze bepaalt welk soort lezer elke kassa gebruikt.
- Alleen Slimme lezers: elke kassa verwerkt betalingen met een slimme lezer.
- Alleen Bluetooth-lezers en Tap to Pay: de iOS- en Android-apps verwerken betalingen met een Bluetooth-lezer of de telefoon. Op een kassa in de browser of desktopapp is de Stripe-tegel ingeklapt onder … momenteel niet beschikbaar, met de tekst Alleen de lezers van de app zijn toegestaan voor deze betaalmethode. Sta slimme lezers toe op de WooCommerce-instellingenpagina van deze betaalmethode om vanaf deze kassa te betalen.
- Beide: kassa's gebruiken de slimme lezers. Bluetooth-lezers en Tap to Pay worden pas gebruikt als je Slimme lezers uitvinkt.
Van lezertype wisselen of upgraden
Als je een soort lezer uitvinkt, verandert alleen waarmee kassa's voortaan betalingen verwerken. Elke betaling wordt terugbetaald via de verbinding waarmee deze is ontvangen, via de slimme lezer of de app, en de webhook van Stripe blijft werken. Bij een upgrade vanaf een oudere versie blijft de opgeslagen verbinding behouden, of worden slimme lezers gebruikt als alleen een Standaardterminal was opgeslagen. Bij een nieuwe installatie zijn beide aangevinkt, dus gebruiken de apps slimme lezers totdat je Slimme lezers uitvinkt.
Een lezer verbinden op deze kassa
Elke kassa onthoudt zijn eigen lezer. Tik in de POS onderaan het zijmenu op Instellingen en vervolgens op Kaartlezers.

- Er zijn geen kaartlezers ingesteld voor deze winkel — dit staat op het scherm totdat de betaalgateway is ingesteld met een soort lezer dat deze kassa kan gebruiken. Daarna verschijnen hier de onderstaande onderdelen voor lezers die deze kassa kan gebruiken (op een kassa in de browser of desktopapp alleen Slimme lezers).
Slimme lezers
Registreer elke slimme lezer in het Stripe-dashboard met de code die de lezer toont. Zolang je dat niet doet, verschijnt de lezer niet onder Standaardterminal, Ingeschakelde terminals of op de kassa.
Het onderdeel Slimme lezers heeft één rij per lezer die de winkel toestaat: de naam van de lezer met daarnaast de naam van de betaalgateway, daaronder de Terminal-locatie en Online of Offline. De kassa verwerkt betalingen met de lezer waarvan de rij is gemarkeerd als Geselecteerd. Tik om te wisselen op Deze lezer gebruiken bij een andere online lezer; bij het afrekenen wordt vervolgens die lezer gebruikt.
Welke lezer wordt automatisch gebruikt?
- Nog niets gekozen: de kassa gebruikt de Standaardterminal zolang deze online en vrij is.
- Slechts één slimme lezer in de winkel: je hoeft niets te kiezen. Zolang de lezer online is en niet bezig is met een andere verkoop, gebruikt de kassa deze voor betalingen.
- Ingesteld door de winkel: de Standaardterminal bij Terminalselectie vergrendelen. Zolang deze online is, staat er op elke kassa Geselecteerd bij en biedt geen enkele rij de optie Deze lezer gebruiken.
Bluetooth-lezers
In de iOS- of Android-app:
- Zet de lezer aan en houd deze in de buurt van de telefoon of tablet.
- Tik in Instellingen → Kaartlezers op Een lezer verbinden. Bij een winkel met meer dan één betaalgateway voor lezers wordt gevraagd welke je wilt gebruiken: Een lezer verbinden met en vervolgens Stripe Terminal.
- Op de rij staat Zoeken naar lezers… Zet de lezer aan en houd deze in de buurt van dit apparaat., gevolgd door 1 lezer gevonden. Is dit jouw lezer? of 3 lezers gevonden. Welke is van jou? Tik op Verbinden naast jouw lezer.
- Bij de eerste verbinding wordt een software-update voor de lezer geïnstalleerd. Op de rij staat Lezersoftware installeren met een voortgangsbalk en Houd de lezer aan en opgeladen. De eerste update duurt ongeveer 10 minuten. Laad de lezer tot meer dan de helft op voordat je begint en blijf op het scherm.
- Op de rij staat Verbonden, met het batterijniveau van de lezer, bijvoorbeeld Verbonden · 80%.
Latere verbindingen duren een paar seconden en bij de volgende verkoop maakt de kassa opnieuw verbinding met dezelfde lezer. Zolang er geen lezer is verbonden, staat in het onderdeel Bluetooth-lezers: Nog geen lezer verbonden. Zet de lezer aan en houd deze in de buurt van deze telefoon.
Tap to Pay
Tap to Pay komt via een app-update naar de iOS- en Android-apps; zo werkt het zodra je app deze functie heeft. Op een telefoon met de iOS- of Android-app bevat het onderdeel Deze telefoon een rij Tap to Pay op iPhone of Tap to Pay op Android. Een winkelmanager of beheerder tikt op Tap to Pay instellen. Alle anderen zien Niet ingesteld · vraag een beheerder.
De eerste keer vraagt de telefoon je de voorwaarden van de aanbieder te accepteren: op een iPhone vraagt Apple je een Apple ID te koppelen en de voorwaarden voor Tap to Pay te accepteren. Na het instellen staat er Gereed op de rij. Tap to Pay heeft een verbinding nodig om een betaling te ontvangen.
Wat er op een lezerrij kan staan
Elke lezerrij toont de naam van de lezer, het serienummer, de Terminal-locatie en één statusregel:
- Verbonden · 80% — klaar om betalingen te ontvangen, met het resterende batterijniveau. Bij Tap to Pay staat Gereed.
- Niet verbonden — de kassa onthoudt deze lezer, maar is er nu niet mee verbonden. Tik op Verbinden.
- Verbinding maken met … — wacht even. Op de knop staat Verbinding maken….
- Lezersoftware installeren — de update; zie Bluetooth-lezers, stap 4.
- Geen lezers gevonden. Zet de lezer aan en probeer het opnieuw. — tik op Opnieuw proberen, of op Zie je je lezer niet? voor de handleiding van de lezer.
- Kan geen verbinding maken: … — daarna volgt de reden van Stripe. Tik op Opnieuw proberen of Help.
- Schakel Bluetooth in om een lezer te verbinden. — Bluetooth is uitgeschakeld op dit apparaat.
- Sta toegang tot de lezer toe in de app-instellingen. — de app heeft geen toestemming om Bluetooth te gebruiken. Geef die toestemming in de instellingen van de telefoon.
Het menu ⋮ naast een rij bevat Vergeten: de kassa maakt bij de volgende verkoop niet meer automatisch verbinding met die lezer. Je kunt deze vanaf deze pagina opnieuw verbinden. Verbinding verbreken, de knop op een verbonden rij, verbreekt de verbinding met de lezer voor nu. Als de app een lezer bezet houdt en deze niet vrijgeeft, biedt het menu ook Lezer vrijgeven.
Testen voordat je live gaat
Vink Testmodus aan op de instellingenpagina van de betaalgateway (WP Admin > WooCommerce > Settings > Payments > Stripe Terminal) en sla op. Betalingen gaan dan naar het testaccount van Stripe en er wordt geen geld verplaatst. Voer een testverkoop uit met de stappen in Een betaling ontvangen.
- Slimme lezers: een gesimuleerde lezer die op je Stripe-testaccount is geregistreerd, verschijnt naast je echte lezers. Zo kun je een verkoop uitvoeren zonder hardware.
- Bluetooth-lezers en echte slimme lezers: betaal met de fysieke testkaart van Stripe, die je bestelt in de Terminal-shop in je Stripe-dashboard. De laatste twee cijfers van het bedrag bepalen de uitkomst:
.00keurt de betaling goed,.05weigert deze en.02vraagt om de pincode1234.
Vink wanneer je klaar bent Testmodus uit en sla op voordat je een echte betaling ontvangt.
Een betaling ontvangen
Als De kassa openen en sluiten is ingeschakeld, registreert de kassa geen betalingen zolang deze gesloten is. Een kaartbetaling die je dan al hebt ontvangen, moet worden terugbetaald. Zie De kassa openen.
-
Vul de winkelwagen en druk op Afrekenen.
-
Tik op de tegel Stripe Terminal in het betaalpaneel.
-
Controleer de lezer. Bij een slimme lezer staat Terminal: …, met Wijzigen om een andere te kiezen als de winkel dat toestaat. Bij een Bluetooth-lezer staat Verbonden · 80%, of Geen lezer verbonden met een link naar Instellingen → Kaartlezers.
-
Druk op … naar Stripe Terminal sturen en laat de klant betalen:
- Slimme lezer: de kassa toont Wachten op de klant bij de terminal terwijl de klant de kaart tegen de lezer houdt, erin steekt of erdoorheen haalt.
- Bluetooth-lezer: de kassa toont Bied de kaart aan bij de lezer.
- Tap to Pay: de telefoon toont het eigen Tap to Pay-scherm en de klant houdt de kaart of telefoon tegen jouw telefoon.
De kassa vinkt Verzonden, Op terminal, Goedgekeurd en Geïnd af.
-
Als er niets meer te betalen is, verschijnt het bonscherm: print of e-mail de bon en druk vervolgens op Nieuwe verkoop. Zie De betaling is voltooid. Staat er nog een deel van het totaal open, ontvang de rest dan op een andere manier; zie Gesplitste betalingen.
Druk om te stoppen op Annuleren op terminal. Bij een geweigerde kaart verschijnt Betaling mislukt: … met Opnieuw proberen en Een andere manier kiezen. Zie Op een kaartlezer.
Op de tegel kun je geen kaartgegevens invoeren. Zie Telefonische bestellingen (MOTO) voor een telefonische bestelling.
Fooien die klanten op de lezer toevoegen, verschijnen als een toeslag Fooi op de bestelling. De WisePad 3, WisePOS E, S700 en S710 kunnen om een fooi vragen; de M2 kan dat niet. Schakel fooien voor je lezers in via het Stripe-dashboard.
Telefonische bestellingen (MOTO)
Bij MOTO (postorder en telefonische bestellingen) betaalt een klant die niet aanwezig is met een kaart: je voert het kaartnummer, de vervaldatum en de beveiligingscode in op het scherm van de lezer, in plaats van de kaart ertegenaan te houden. Telefonische bestellingen werken alleen op het tabblad Verouderd van de kassa, in het eigen paneel van Stripe. De tegel Stripe Terminal op het tabblad Betalingen biedt geen optie om kaartgegevens in te voeren.
De schakelaar Telefonische bestelling wordt alleen weergegeven als aan alle drie de volgende voorwaarden is voldaan:
- Stripe schakelt MOTO in voor je account. Dit is standaard niet ingeschakeld: neem contact op met Stripe-support.
- Vink Telefonische bestellingen (MOTO) aan. Ga naar
WP Admin > WooCommerce > Settings > Payments > Stripe Terminal, vink Telefonische bestellingen (MOTO) aan en sla op. - Gebruik een slimme lezer van het type S700, S710 of WisePOS E. De schakelaar wordt weergegeven zodra een van deze apparaten is verbonden in het paneel van Stripe. De schakelaar wordt nooit weergegeven voor een P400, M2, WisePad 3, Tap to Pay of een gesimuleerde lezer.
Als Telefonische bestellingen (MOTO) is aangevinkt, vervangt het eigen paneel van Stripe het gebruikelijke paneel voor elke betaling via Stripe Terminal op het tabblad Verouderd, niet alleen voor telefonische bestellingen. Als de optie niet is aangevinkt, toont het tabblad Verouderd een keuzelijst Terminal met Verzenden naar terminal, Annuleren en Opnieuw proberen. De betaling wordt geregistreerd zoals een betaling via het betaalvenster.
Een telefonische bestelling aannemen:

- Verouderd — het tabblad dat de eigen betaalpagina van de winkel binnen de kassa toont.
- De betaalpagina van de winkel — kies hier Stripe Terminal en scroll vervolgens omlaag naar Beschikbare lezers, Verbinden en Telefonische bestelling.
- Betaling verwerken — de knop van de kassa onder de pagina, net als bij elke betaling via Verouderd. Je start een telefonische bestelling met Betalen met terminal op de pagina.
- Druk op Afrekenen, open het tabblad Verouderd en kies Stripe Terminal.
- Druk onder Beschikbare lezers op Verbinden bij je lezer.
- Schakel Telefonische bestelling in.
- Druk op Betalen met terminal. De lezer toont een scherm om kaartgegevens in te voeren in plaats van te vragen een kaart tegen de lezer te houden.
- Voer het kaartnummer, de vervaldatum en de beveiligingscode in op de lezer.
Stripe behandelt een telefonische bestelling als een betaling zonder aanwezige kaart. De tarieven voor betalingen met een aanwezige kaart en de bijbehorende verschuiving van aansprakelijkheid bij fraude zijn daarom niet van toepassing.
Als er iets misgaat
De lezer maakt geen verbinding. Een slimme lezer moet verbonden zijn via wifi of Ethernet, online zijn in je Stripe-dashboard en daar geregistreerd zijn. Voor een Bluetooth-lezer heb je de iOS- of Android-app nodig, moet Bluetooth aanstaan en moet de app toestemming hebben om Bluetooth te gebruiken.
‘Selecteer een Terminal-locatie…’. De betaalgateway heeft geen Terminal-locatie voor de huidige modus, test of live. Zie De betaalgateway instellen, stap 3.
De eerste verbinding duurt erg lang. Dat komt door de software-update van de lezer, die ongeveer 10 minuten duurt. Houd de lezer aan en opgeladen en blijf op het scherm. De volgende verbinding duurt slechts enkele seconden.
De Stripe-tegel geeft aan dat deze niet beschikbaar is. Op een kassa in de browser of desktopapp staat de winkel alleen de lezers van de app toe. Zie Slimme lezers, Bluetooth of beide. Offline wachten kaartlezers op de verbinding; zie Offlinemodus.
Bij Kaartlezers staat Alleen de lezers van de app zijn toegestaan voor deze winkel. Dit heeft op een kassa in de browser of desktopapp dezelfde oorzaak: sta Slimme lezers toe onder POS-verbindingen of gebruik de iOS- of Android-app. Zie Slimme lezers, Bluetooth of beide.
De kaart wordt geweigerd. Vraag om een andere kaart of een andere betaalmethode. Controleer in testmodus de laatste twee cijfers van het bedrag.
Geen schakelaar voor Telefonische bestelling. Telefonische bestellingen werken alleen op het tabblad Verouderd, niet via de tegel Stripe Terminal. Controleer of Telefonische bestellingen (MOTO) is aangevinkt, of je verbonden bent met een S700, S710 of WisePOS E en of het geen gesimuleerde lezer is.
Een telefonische bestelling mislukt. Stripe heeft MOTO nog niet ingeschakeld voor je account of de kaartgegevens zijn verkeerd ingevoerd.
Kom je er nog steeds niet uit? Meld een bug op GitHub, raadpleeg de Terminal-documentatie van Stripe voor de lezer of neem contact op met Stripe-support over je account.