Mollie Terminal Gateway
Met de Mollie Terminal-gateway kun je persoonlijke betalingen innen op Mollie Terminal-hardware, rechtstreeks vanuit WCPOS. Een betaling wordt gestart vanuit WooCommerce en voltooid op de terminal, en de bevestiging van Mollie wordt teruggeschreven naar de bestelling.
Functies
Hardware-integratie
Stuur betalingen naar Mollie-terminals die op je Mollie-account zijn geregistreerd en accepteer kaartbetalingen met de kaart aanwezig
Geen handmatige koppeling
Terminals worden live opgehaald uit je Mollie-account — kies er een uit een keuzelijst, geen apparaat-ID om te plakken
Betrouwbare voltooiing
Betalingen worden bevestigd door Mollie te pollen, en de POS gaat automatisch door naar de bon zodra de terminal bevestigt
Veilige transacties
PCI-conforme verwerking van kaartbetalingen met de kaart aanwezig op Mollie-hardware
Terugbetalingen ondersteund
Betaal terug vanaf het WooCommerce-bestelscherm, afgestemd op Mollie zodat terugbetalingen nooit dubbel gebeuren
Hoe het werkt
Mollie Terminal gebruikt de server-side pointofsale-betalingen van Mollie. Wanneer je een betaling start, maakt WooCommerce een Mollie-betaling voor de bestelling aan en pusht Mollie die naar de geselecteerde terminal. De klant betaalt op het apparaat, en Mollie is de gezaghebbende bron voor de status van betalingen en terugbetalingen — de lokale WooCommerce-bestelmeta is alleen een cache.
Hoe een betaling wordt bevestigd. Terwijl de betaling loopt, pollt de POS Mollie (standaard elke 2 seconden) en gaat direct door naar de bedanktpagina zodra de terminal bevestigt. Mollie-webhooks worden ook gebruikt om dit te versnellen — en de webhook-URL wordt bij elke betaling automatisch ingesteld, dus er valt niets te configureren in het Mollie-dashboard.
De terminal moet geregistreerd en actief zijn op hetzelfde Mollie-account als de plugin.
Installatie
Installeer Mollie 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.
Configureer je Mollie-inloggegevens
- Ga naar
WP Admin > WooCommerce > Settings > Paymentsen open Mollie Terminal - Zet Mode op
Live— terminalbetalingen vereisen een live account (zie Bereik en beperkingen) - Stel API key source in om de sleutel van de officiële plugin Mollie Payments for WooCommerce te hergebruiken, of om de sleutel te gebruiken die je op dit scherm invoert
- Als je de sleutel hier invoert, plak dan je live API-sleutel van Mollie in Mollie API Key
- Sla op
Mollie-terminals bestaan alleen op live accounts, dus de test-API-sleutel kan geen terminal aansturen. Het instellingenscherm waarschuwt je wanneer de modus Test is geselecteerd — schakel over naar Live met je live API-sleutel om betalingen te innen. Zie Bereik en beperkingen.
pointofsale-betalingen hebben geen Mollie Profile ID nodig, en terminals worden voor het hele account weergegeven, dus er valt verder niets te plakken.
Kies je terminals
- Kies een Default terminal uit de keuzelijst. De lijst wordt opgehaald uit de geselecteerde Mollie-omgeving — inactieve terminals worden verborgen, omdat Mollie ze niet opnieuw kan activeren.
- (Optioneel) Beperk Enabled terminals tot de apparaten die daadwerkelijk in gebruik zijn. De opgeslagen standaardterminal blijft beschikbaar, ook als die hier niet is geselecteerd; laat de instelling leeg om alle actieve terminals toe te staan. Wil je een terminal uit dienst nemen, wijzig of wis dan ook Default terminal.
- (Optioneel) Schakel Lock terminal selection in zodat kassamedewerkers de terminal bij het afrekenen niet kunnen wijzigen — de standaardterminal wordt altijd gebruikt, en dit wordt ook op de server afgedwongen.
- Sla op
Inschakelen in WCPOS
- Ga naar
WP Admin > POS > Settings > Checkout - Zoek de Mollie Terminal-gateway en schakel die in voor de POS
- Sla je instellingen op
Het selectievakje Enable/Disable op het WooCommerce-instellingenscherm bepaalt alleen het afrekenen in de onlinewinkel. WCPOS gebruikt deze gateway zodra die is geconfigureerd, ongeacht of dat vakje is aangevinkt.
Overzicht van instellingen
| Instelling | Wat het doet |
|---|---|
| Enable/Disable | Schakelt de gateway in voor het afrekenen in de onlinewinkel (niet nodig voor de POS) |
| Title / Description | Het label en de tekst die de klant bij het afrekenen ziet |
| Mode | Test of Live. Terminalbetalingen vereisen Live — de test-API-sleutel kan geen terminal aansturen |
| API key source | Gebruikt de sleutel die hieronder is ingevoerd, of hergebruikt de bijbehorende test- of live-sleutel van de officiële plugin Mollie Payments for WooCommerce. Is de gedeelde sleutel niet beschikbaar, dan valt de plugin terug op de sleutel hieronder |
| Mollie API Key | De test- of live-API-sleutel voor de geselecteerde modus. Wordt gebruikt wanneer API key source op de hier ingevoerde sleutel staat, en als terugval bij een ontbrekende gedeelde sleutel |
| Default terminal | De terminal die standaard bij het afrekenen wordt gebruikt, gekozen uit een keuzelijst met actieve terminals in de geselecteerde Mollie-omgeving |
| Enabled terminals | Beperkt de lijst bij het afrekenen tot geselecteerde terminals. Leeg = alle actieve terminals. De opgeslagen standaardterminal is altijd beschikbaar, dus wijzig of wis die ook wanneer je een terminal uit dienst neemt |
| Lock terminal selection | Dwingt de standaardterminal af bij het afrekenen zodat kassamedewerkers die niet kunnen wijzigen (vereist een standaardterminal) |
| Checkout debug logs | Toont de knoppen Show logs, Copy en Clear op het betaalpaneel bij het afrekenen. Laat dit uit staan tenzij je logs verzamelt voor support; betalingsactiviteit wordt altijd vastgelegd onder WooCommerce > Status > Logs |
De webhook-URL wordt bij elke betaling automatisch toegepast, dus er is geen webhook-veld om in te vullen en er is geen configuratie in het Mollie-dashboard nodig.
Gebruik
Betalingen verwerken
- Artikelen toevoegen: Voeg producten toe aan je winkelwagen in de POS
- Gateway selecteren: Kies „Mollie Terminal” als betaalmethode
- Terminal kiezen: Kies een terminal uit de keuzelijst (standaard de geconfigureerde terminal; verborgen wanneer de terminalkeuze is vergrendeld)
- Betaling starten: Klik op Start Terminal Payment — Mollie pusht de betaling naar het apparaat
- Klantbetaling: De klant tikt, steekt of haalt de kaart door op de terminal. De status wordt live bijgewerkt —
Sending to terminal…→Waiting for terminal… - Automatische voltooiing: Zodra de terminal bevestigt, wordt de bestelling als betaald gemarkeerd en gaat de POS automatisch door naar de bon
Betalingsbediening
- Start Terminal Payment: Stuur een nieuw betalingsverzoek naar de geselecteerde terminal
- Cancel Payment: Annuleer een betaling die nog openstaat. Zodra de betaling de terminal heeft bereikt, meldt Mollie dat die niet meer te annuleren is en annuleert de kassamedewerker op het apparaat zelf
Bestellingsbeheer
- Geverifieerde voltooiing: Elke webhook, poll, annulering en nieuwe poging haalt de gezaghebbende Mollie-status op voordat een bestelling wordt gewijzigd, zodat bestellingen alleen bij een bevestigde Mollie-status als betaald worden gemarkeerd
- Betalingstracking: Betaalpogingen worden bij de bestelling vastgelegd als geschiedenis waaraan alleen wordt toegevoegd
- Bonnen genereren: Na succesvolle betalingen worden standaard POS-bonnen gegenereerd
Terugbetalingen
Terugbetalingen worden ondersteund. Betaal een bestelling terug vanaf het gewone WooCommerce-bestelscherm en de terugbetaling wordt naar Mollie gestuurd. Omdat Mollie de gezaghebbende bron is, worden nieuwe pogingen tot terugbetaling eerst afgestemd op de terugbetalings-ID's en metadata van Mollie voordat er een nieuwe terugbetaling wordt aangemaakt, zodat een terugbetaling nooit per ongeluk twee keer wordt uitgevoerd.
Blijven hangende betalingen opruimen
Een pointofsale-betaling van Mollie kan aan de kant van Mollie „open” blijven staan wanneer een afrekening wordt afgebroken. De plugin annuleert deze openstaande betalingen automatisch wanneer:
- de automatische polling verloopt (standaard 5 minuten) — de annulering wordt verstuurd in plaats van de betaling te laten staan
- de bestelling wordt voltooid met een andere betaalmethode (bijvoorbeeld wanneer de klant contant betaalt), of de bestelling in WooCommerce wordt geannuleerd
- de afrekenpagina midden in een betaling wordt gesloten — er wordt een annulering geprobeerd wanneer het tabblad wordt verlaten
- een WP-Cron-veegactie elke 10 minuten draait en betalingen annuleert of afhandelt die langer dan de drempelwaarde (standaard 10 minuten) open zijn blijven staan, ook wanneer de browser wordt gesloten of het netwerk wegvalt voordat de andere opruimroutes hebben kunnen draaien
Als de betaling de terminal al heeft bereikt, meldt Mollie dat die niet te annuleren is en annuleert de kassamedewerker op het apparaat zelf — deze opruimacties doen in dat geval veilig niets.
Vereisten
Bereik en beperkingen
Mollie-terminals bestaan alleen op live accounts. De test-API-sleutel van Mollie kan geen fysieke (of iOS-/Android-)terminal aansturen, dus terminalbetalingen kunnen in de testmodus niet van begin tot eind worden doorlopen. Dit is een beperking van het Mollie-platform, geen beperking van de plugin — het instellingenscherm toont een waarschuwing wanneer de modus Test is geselecteerd. Gebruik de modus Live met je live API-sleutel om terminalbetalingen te innen.
POS-terminalbetalingen zijn beperkt tot EUR totdat bredere valuta-ondersteuning voor Mollie Terminal is bevestigd.
Problemen oplossen
Veelvoorkomende problemen
Er verschijnen geen terminals in de keuzelijst
- Controleer of Mode op
Livestaat en of de gebruikte API-sleutel een live-sleutel is — terminals bestaan niet op testaccounts - Controleer of de terminal is geregistreerd en actief is op je Mollie-account; inactieve terminals worden verborgen omdat Mollie ze niet opnieuw kan activeren
- Zorg dat je site Mollie kan bereiken — de lijst wordt live via de API opgehaald
De betaling start niet
- Controleer of er een terminal is geselecteerd (of dat er een Default terminal is ingesteld wanneer de keuze is vergrendeld)
- Controleer of de terminal is ingeschakeld, online is en actief is op hetzelfde Mollie-account
- Controleer of de valuta van de bestelling EUR is
De terminal verliep of de betaling bleef openstaan
- De plugin probeert openstaande betalingen bij een time-out automatisch te annuleren (standaard 5 minuten)
- Als de betaling de terminal al heeft bereikt en niet automatisch geannuleerd kan worden, annuleer die dan op het apparaat zelf
- Daarna kun je een nieuwe betaling starten of op een andere manier betalen
De bestelling is op de terminal voltooid, maar wordt traag bijgewerkt
- De POS pollt Mollie elke 2 seconden en gaat door zodra de betaling wordt bevestigd; meestal bevestigt een webhook het als eerste
- Omdat Mollie de gezaghebbende bron is, wordt de bestelling afgestemd op de gezaghebbende Mollie-status — er gaat niets verloren
- Bekijk
WooCommerce > Status > Logsvoor eventuele meldingen van de Mollie-API
Hulp krijgen
Voor technische ondersteuning:
- Bezoek de GitHub-opslagplaats om problemen te melden
- Raadpleeg de Mollie Terminal-installatiehandleiding en de Mollie Create Payment API voor API-gerelateerde vragen
- Neem contact op met Mollie-support voor vragen over je account en de hardware
Schermafbeeldingen
Schermafbeeldingen worden in een toekomstige update toegevoegd om het volgende te tonen:
- Het instellingenscherm van Mollie Terminal — API-sleutel, standaardterminal en ingeschakelde terminals
- Het inschakelen van de gateway in de WCPOS-instellingen
- De workflow voor het verwerken van betalingen bij het afrekenen in de POS