WooCommerce betaalgateway niet zichtbaar bij het afrekenen

Het symptoom is altijd hetzelfde: WooCommerce-instellingen toont de gateway als ingeschakeld, maar de afrekenpagina toont geen betaalopties of slaat de gateway helemaal over. De klant kan geen bestelling afronden. De oorzaak is bijna nooit een enkele instelling — het is meestal een mismatch tussen hoe de gateway is gebouwd en hoe de afrekenpagina wordt gerenderd.

Waarom betaalgateways verdwijnen van de WooCommerce-afrekenpagina

WooCommerce heeft twee afrekensystemen die naast elkaar draaien. De Classic Checkout gebruikt de [woocommerce_checkout]-shortcode en rendert gateways via PHP-hooks. Het Checkout Block (de standaard voor nieuwe installaties sinds WooCommerce 8.3, november 2023) gebruikt de blokeditor en rendert gateways via een JavaScript-API. Een gateway die alleen voor de Classic Checkout is gebouwd, verschijnt niet in het Checkout Block, en WooCommerce geeft hier geen waarschuwing over. De pagina toont simpelweg minder betaalopties dan verwacht.

Dit is de meest voorkomende oorzaak van ontbrekende gateways op webshops die na november 2023 zijn aangemaakt of gemigreerd, en het eerste dat je moet controleren.

Stap 1: controleer Checkout Block vs. Classic Checkout-compatibiliteit

Open de pagina die als afrekenpagina dient (meestal /checkout/ of /afrekenen/). Bewerk deze in de WordPress-blokeditor.

• Als je een Checkout-blok ziet (een groot blok met verzend-, factuur- en betaalsecties als visuele layout), gebruik je het Checkout Block.
• Als je een shortcode-blok ziet met [woocommerce_checkout], gebruik je Classic Checkout.

Bij gebruik van het Checkout Block

De gateway moet de Block Checkout payment method API implementeren. Niet alle gateways doen dat. Controleer de documentatie of changelog van de gateway op "Checkout Block support" of "Block Checkout compatible."

Om te testen of het Checkout Block het probleem is, schakel tijdelijk over naar Classic Checkout:

1. Bewerk de afrekenpagina
2. Verwijder het Checkout-blok
3. Voeg een Shortcode-blok toe met [woocommerce_checkout]
4. Sla op en test de afrekenpagina in een incognitovenster

Als de gateway verschijnt met Classic Checkout maar niet met het Checkout Block, mist de gateway blokondersteuning. Neem contact op met de gateway-ontwikkelaar of gebruik Classic Checkout tot blokondersteuning is toegevoegd.

Grote gateways en hun blokondersteuningsstatus

• WooCommerce Stripe: blokcompatibel sinds versie 7.0. Bij een oudere versie: bijwerken.
• WooCommerce PayPal Payments: blokcompatibel sinds versie 2.0.
• Mollie voor WooCommerce: blokcompatibel sinds versie 7.0.
• Aangepaste of niche-gateways: controleer bij de ontwikkelaar. Veel kleinere gateways hebben de Block Checkout API nog niet geïmplementeerd.

Stap 2: controleer of het SSL-certificaat actief en afgedwongen is

Betaalgateways die kaartgegevens verwerken vereisen HTTPS. WooCommerce zelf verbergt gateways die SSL nodig hebben wanneer de afrekenpagina niet via een geldig certificaat wordt geserveerd.

Controleer in je browser: begint de afreken-URL met https:// en toont het een slotje? Zo niet, dan verbergt de gateway zichzelf bij ontwerp. Zie de WordPress SSL-certificaatgids voor het installeren en verifiëren van een certificaat.

Controleer ook of WordPress is geconfigureerd voor HTTPS:

1. Ga naar Instellingen > Algemeen
2. Zowel WordPress-adres als Siteadres moet met https:// beginnen
3. Als ze http:// tonen, werk ze bij en test opnieuw

WooCommerce heeft een extra SSL-afdwingingsoptie bij WooCommerce > Instellingen > Geavanceerd > Pagina-instellingen: "Beveiligde afrekening afdwingen" moet ingeschakeld zijn als je sitebreed HTTPS gebruikt.

Stap 3: testmodus, API-sleutels en geografische beperkingen

Testmodus vs. live-modus

De meeste gateways hebben een test-/sandbox-modus. Een gateway in testmodus verschijnt alleen wanneer de winkel in testmodus staat (of bij weergave als beheerder, afhankelijk van de gateway). Omgekeerd faalt een gateway met testsleutels maar "Live-modus" geselecteerd stilzwijgend.

Controleer: WooCommerce > Instellingen > Betalingen > [Jouw Gateway]. Verifieer:

• De modus (test of live) klopt met je bedoeling
• De API-sleutels passen bij de geselecteerde modus (testsleutels voor testmodus, live-sleutels voor live-modus)
• Bij Stripe specifiek: publiceerbare en geheime sleutels zijn niet verwisseld

Geografische beperkingen

Sommige gateways beperken zich tot specifieke landen of valuta's. PayPal ondersteunt bijvoorbeeld niet elke valuta. Stripe-beschikbaarheid hangt af van het registratieland van de verkoper.

Controleer: WooCommerce > Instellingen > Betalingen > [Jouw Gateway] voor eventuele land- of valutabeperkingen. Controleer ook WooCommerce > Instellingen > Algemeen > Verkooplocatie(s) om te bevestigen dat de ondersteunde regio's van de gateway overlappen met je verkooplanden.

Klant-side filtering

WooCommerce-gateways kunnen aangeven welke facturatielanden ze ondersteunen via de get_supported_currencies()- en is_available()-methoden. Een klant wiens factuuradres buiten de ondersteunde regio valt, ziet de gateway niet. Test met een factuuradres in een regio die de gateway expliciet ondersteunt.

Stap 4: plugin- en themaconflict isoleren

Een JavaScript-fout van een andere plugin kan voorkomen dat het checkout-script van de gateway initialiseert. Dit komt vooral voor bij:

• Cachingplugins die verouderde afrekenpagina's serveren (zie de WooCommerce winkelwagen-probleemoplossingsgids voor cache-uitsluitingsregels)
• JavaScript-optimalisatieplugins die scripts uitstellen of combineren, waardoor gateway-initialisatie breekt
• Aangepaste thema's die checkout-templates overschrijven

Snelle diagnose

1. Open de afrekenpagina in een incognitovenster
2. Open browser-DevTools (F12) > Console-tab
3. Zoek naar JavaScript-fouten in rood

Als je fouten ziet van een niet-gateway script, is die plugin waarschijnlijk de oorzaak.

Conflicttest

1. Schakel over naar een standaardthema (Twenty Twenty-Four of Storefront)
2. Deactiveer alle plugins behalve WooCommerce en de betaalgateway
3. Test de afrekenpagina
4. Als de gateway verschijnt, activeer plugins één voor één opnieuw om het conflict te vinden

Stap 5: WooCommerce-debuglogging inschakelen en het gatewaylog lezen

Als de gateway na de bovenstaande stappen nog steeds niet verschijnt, schakel logging in om te zien wat WooCommerce en de gateway intern rapporteren.

1. Ga naar WooCommerce > Instellingen > Geavanceerd > WooCommerce.com
2. Schakel Logging inschakelen in (of navigeer naar WooCommerce > Status > Logs)
3. Probeer een afrekening
4. Controleer het log voor de gateway (bijv. woocommerce-stripe of woocommerce-paypal)

Veelvoorkomende logregels die een verborgen gateway verklaren:

• SSL is not enabled — de gateway verborg zichzelf omdat HTTPS vereist is
• Invalid API key — de gateway kon niet authenticeren en schakelde zichzelf uit
• Currency not supported — de winkelvaluta komt niet overeen met de vereisten van de gateway

WooCommerce-systeemstatus

WooCommerce > Status biedt een diagnose op één pagina. Controleer op:

• WordPress-omgeving > Beveiligde verbinding (HTTPS): moet een groen vinkje zijn
• Actieve plugins: verifieer dat de gatewayplugin in de lijst staat zonder foutmeldingen
• WC-pagina's: verifieer dat de afrekenpagina is toegewezen

Gatewayspecifieke opmerkingen

Stripe

De WooCommerce Stripe-extensie heeft twee opvallende incidenten gehad in 2025:

• Versie 9.4.0 (april 2025) introduceerde API-synchronisatiegedrag dat Stripe rate limiting triggerde, wat leidde tot onbeschikbaarheid van het afrekenen. De hotfix was versie 9.4.1.
• Versie 9.5.0 (mei 2025) veroorzaakte checkout-storingen; de hotfix was 9.5.2.

Als Stripe plotseling verdwijnt van de afrekenpagina, controleer of de plugin recentelijk automatisch is bijgewerkt. Terugdraaien naar de vorige stabiele versie is een geldige noodoplossing terwijl je op een patch wacht.

PayPal

PayPal's nieuwere "WooCommerce PayPal Payments"-plugin vervangt de verouderde "PayPal Standard"-integratie. Als beide plugins actief zijn, kunnen ze conflicteren. Deactiveer de verouderde plugin als de nieuwere is geïnstalleerd.

iDEAL, Bancontact en lokale Europese methoden

Deze worden doorgaans aangeboden via Mollie, Adyen of MultiSafepay-aggregatoren in plaats van rechtstreeks. Als de individuele methode niet verschijnt, controleer de instellingen van de aggregatorplugin — individuele betaalmethoden hebben meestal hun eigen aan-/uitschakelaar binnen de configuratie van de aggregator.

Wat een ontbrekende gateway NIET is

• Niet altijd een API-sleutelprobleem. API-sleutelfouten voorkomen dat transacties worden voltooid, maar ze voorkomen niet altijd dat de gateway verschijnt. De Checkout Block-incompatibiliteit beschreven in stap 1 is een veel vaker voorkomende oorzaak van een volledig onzichtbare gateway.
• Niet op te lossen door alleen de paginacache te legen. Cache kan een verouderde afrekenpagina serveren, maar de oplossing is het afrekenen uitsluiten van caching, niet herhaaldelijk de cache legen. Als de gateway niet verschijnt bij een cache-omzeilend verzoek (incognitovenster met ?nocache of een cache-busting queryparameter), is caching niet de oorzaak.
• Niet altijd zichtbaar in WooCommerce-instellingen. Een gateway kan "ingeschakeld" zijn in WooCommerce > Instellingen > Betalingen maar toch verborgen voor de klant door de eigen interne is_available()-logica (SSL-controles, landbeperkingen, valutamismatches). "Ingeschakeld" betekent "geconfigureerd," niet "zichtbaar voor alle klanten."