woocommerce_available_payment_gateways
Het filter woocommerce_available_payment_gateways ontvangt de betaalmethoden die WooCommerce in de huidige situatie beschikbaar acht. De callback moet een array teruggeven met interne gateway-ID's als sleutels en WC_Payment_Gateway-objecten als waarden. ID's zoals cod (betaling bij levering) en bacs (bankoverschrijving) zijn niet de vertaalde namen die klanten zien.
| Type | Filterhook |
|---|---|
| Argument en retourwaarde | $gateways (array) |
| Bron | WooCommerce-klasse voor betaalmethoden |
Betaling bij levering verbergen zonder verzending
add_filter( 'woocommerce_available_payment_gateways', function ( $gateways ) {
if ( WC()->cart && ! WC()->cart->needs_shipping() ) {
unset( $gateways['cod'] );
}
return $gateways;
} );
Hiermee verdwijnt betaling bij levering wanneer de winkelwagen geen verzending nodig heeft, bijvoorbeeld bij uitsluitend virtuele producten. De controle op het winkelwagenobject voorkomt dat de code aanneemt dat er altijd een winkelwagen bestaat. Dit filter verwijdert een beschikbare keuze; het registreert geen nieuwe betaalmethode. Plaats de callback in een sitespecifieke plug-in of in functions.php van een child-thema en test de relevante winkelwagens en betaalopties.
Afrekenproces en compatibiliteit
Als je alle beschikbare betaalmethoden verwijdert, kan een klant mogelijk niet meer betalen. Controleer winkelwagens met fysieke en virtuele producten, verzendbestemmingen en bestellingen waarvoor geen betaling nodig is. WooCommerce kan de beschikbare methoden ook buiten het normale klantafrekenproces opvragen. Code die de winkelwagen of sessie gebruikt, moet daarom rekening houden met ontbrekende gegevens. Voor regels op basis van verzendzones kun je de handleiding voor betaalmethoden per verzendzone raadplegen.
Dit filter wordt gebruikt bij klassiek afrekenen en wordt gedeeltelijk ondersteund in het Checkout-blok. Een bestaande betaalmethode verwijderen kan daar werken, maar voor het toevoegen of veranderen van een betaalmethode kan een blokspecifieke integratie nodig zijn. Zie de compatibiliteitsinformatie over blokhooks van WooCommerce en controleer de daadwerkelijke afrekenpagina.