Mollie is voor veel Nederlandse webshops de vanzelfsprekende keuze als betaalprovider. Geen maandelijkse kosten, iDEAL en de meeste andere methoden in één account, een plugin die goed onderhouden wordt. De koppeling met WooCommerce is dan ook snel gelegd: plugin installeren, API-sleutel plakken, klaar. Dat is ook precies waar het vaak misgaat. Niet bij de koppeling zelf, maar bij de instellingen die daarna niemand meer bekijkt.

In dit artikel lopen we het instellen van Mollie in WooCommerce stap voor stap door, met nadruk op de instellingen die in de praktijk worden overgeslagen en later problemen geven. Denk aan bestellingen die op de verkeerde status blijven staan, betaalmethoden die niet verschijnen of een shop die per ongeluk maandenlang in testmodus draait. Het is geen handleiding voor het aanmaken van een Mollie-account; die stap gaan we ervan uit dat u heeft gezet.

Stap 1: de plugin en de sleutels

Gebruik de officiële plugin “Mollie Payments for WooCommerce”. Er zijn alternatieven, maar de officiële wordt door Mollie zelf onderhouden en volgt wijzigingen in hun API het snelst. Na installatie vindt u de instellingen onder WooCommerce, Instellingen, Betalingen, en dan het tabblad van Mollie.

U heeft twee sleutels nodig uit uw Mollie-dashboard: een live-sleutel en een test-sleutel. Plak ze allebei. De live-sleutel begint met “live_”, de test-sleutel met “test_”. Een veelgemaakte fout is alleen de test-sleutel invullen, de shop testen, en vergeten over te schakelen. Alles lijkt te werken, maar er komt geen euro binnen.

Vlak onder de sleutels staat het vinkje “Testmodus inschakelen”. Zet dit aan tijdens het testen en zet het uit voordat u live gaat. Schrijf het op als een taak, want het is de instelling die het vaakst wordt vergeten.

Stap 2: betaalmethoden activeren op twee plekken

Dit is een bron van verwarring. Een betaalmethode moet op twee plekken aanstaan: in uw Mollie-dashboard (onder Instellingen, Website-profielen) én in WooCommerce. Staat iDEAL wel in Mollie maar niet in WooCommerce, dan ziet de klant hem niet. Staat hij wel in WooCommerce maar niet in Mollie, dan krijgt de klant een foutmelding na de klik.

Na het invullen van de sleutels haalt de plugin de beschikbare methoden op uit Mollie. Ziet u een methode niet, klik dan in de plugininstellingen op de knop om de methoden opnieuw op te halen. Activeer daarna per methode in WooCommerce, en geef elke methode een Nederlandse titel die klanten herkennen (“iDEAL” is duidelijk, “Bancontact” ook, maar “Credit card” mag “Creditcard” heten).

Een instelling die vaak onbenut blijft: per betaalmethode kunt u een minimum- en maximumbedrag instellen en de methode beperken tot bepaalde landen. Handig om bijvoorbeeld achteraf betalen alleen aan te bieden boven een bepaald bedrag. Maar controleer bij problemen altijd eerst of hier niet per ongeluk iets staat ingevuld.

Stap 3: de orderstatussen

Hier gaan de meeste dingen mis die u pas weken later opmerkt. WooCommerce werkt met orderstatussen: In afwachting, In behandeling, Voltooid, Geannuleerd, en meer. Mollie stuurt na een betaling een berichtje (de webhook) en de plugin zet de order dan op een nieuwe status. Welke, bepaalt u in de instellingen.

  • Betaling geslaagd: standaard gaat de order naar “In behandeling”. Dat is juist voor fysieke producten die verzonden moeten worden. Verkoopt u digitale producten of diensten, dan wilt u vaak direct “Voltooid”.
  • Betaling geannuleerd of verlopen: standaard “Geannuleerd” of “In afwachting”. Hier is een afweging. Zet u verlopen betalingen op Geannuleerd, dan wordt de voorraad vrijgegeven. Laat u ze op In afwachting, dan kan de klant later nog betalen, maar blijft de voorraad gereserveerd.
  • Verlooptijd van een betaling: hoelang een klant heeft om te betalen voordat de order verloopt. Bij iDEAL is dat kort, bij bankoverschrijving kan dat dagen zijn. Stem dit af op uw voorraadbeleid.

Controleer na het instellen met een testbestelling of de statussen doen wat u verwacht. Een order die na een geslaagde betaling op “In afwachting” blijft, betekent meestal dat de webhook niet aankomt; daarover meer bij de valkuilen.

Stap 4: de webhook en uw firewall

De plugin stelt het webhookadres automatisch in; u hoeft het niet zelf in het Mollie-dashboard te zetten. Maar de webhook moet uw site wel kunnen bereiken. Drie dingen die dat tegenhouden:

  1. Een beveiligingsplugin of firewall die verkeer van onbekende servers blokkeert. Zet de servers van Mollie op de toegestane lijst.
  2. Een onderhoudsmodus of “binnenkort online”-pagina die ook de webhook een 503 geeft.
  3. Een wachtwoordbeveiliging op de hele site (bijvoorbeeld tijdens de bouw), waardoor Mollie niet binnenkomt.

In het Mollie-dashboard kunt u per betaling zien of de webhook succesvol is afgeleverd. Controleer dat na uw eerste testbetaling; het is de snelste manier om te zien of de terugkoppeling werkt.

Stap 5: testen, in twee rondes

Eerst in testmodus: plaats een bestelling met elke geactiveerde betaalmethode. Mollie biedt in testmodus een scherm waarin u zelf kiest of de betaling slaagt, mislukt of verloopt. Doorloop alle drie en kijk wat er met de order gebeurt, wat de klant per e-mail ontvangt en of de voorraad klopt.

Daarna in live-modus: één echte iDEAL-betaling van een klein bedrag, die u direct terugstort vanuit het orderscherm. Het lijkt overbodig na het testen, maar het is de enige manier om zeker te weten dat de live-sleutel juist is en de webhook op de live-omgeving aankomt.

Valkuilen die u pas later tegenkomt

  • Testmodus blijft aan. Genoemd, maar het verdient herhaling. Zet een reminder.
  • Na een verhuizing of domeinwijziging werkt de webhook niet meer. De plugin gebruikt uw site-URL; controleer die na elke verhuizing en plaats een testbetaling.
  • De afrekenpagina wordt gecachet. Betaalmethoden verschijnen niet of geven een verlopen sessie. Sluit de checkout uit van caching.
  • Terugbetalingen vanuit WooCommerce lukken niet. Dat vereist dat de API-sleutel rechten heeft voor terugbetalingen, en dat er saldo is bij Mollie.
  • De plugin loopt achter. Mollie wijzigt zijn API van tijd tot tijd; een plugin die lang niet is bijgewerkt, kan stoppen met werken. Neem de betaalplugin mee in uw maandelijkse update-ronde, altijd eerst op een testkopie.

Valt iDEAL ondanks een goede inrichting uit, dan helpt ons artikel over iDEAL dat niet werkt in uw webshop bij het vinden van de oorzaak. En blijven bestellingen hangen op “in afwachting” terwijl het geld wel binnen is, dan wijst dat vrijwel altijd op de webhook uit stap 4.

Het instellen van Mollie is werk van een uur, als u het in deze volgorde doet en de twee testrondes niet overslaat. Wat daarna blijft, is het bijhouden: de plugin actueel houden, na elke wijziging aan de shop een testbetaling doen, en de statussen af en toe controleren. Dat is precies het soort terugkerende zorg dat onder onderhoud van een WooCommerce-webshop valt, of het nu door uzelf of door iemand anders wordt gedaan. Wie de koppeling ook heeft gelegd, de instellingen van vandaag bepalen of uw shop over een half jaar nog zonder gedoe afrekent.