WooCommerce-betaalmethoden verbergen per verzendzone

Verberg Cash on Delivery of een andere WooCommerce-betaalmethode voor één verzendzone, maar houd die methode beschikbaar voor klanten in andere gebieden.

Laatst bijgewerkt:

Engelstalig origineel op juistheid gecontroleerd door Jesse Nickles

Probeer eerst de ingebouwde beperking voor Cash on Delivery

Wil je alleen Cash on Delivery (COD) beperken, ga dan naar WooCommerce → Settings → Payments → Take offline payments → Cash on Delivery → Manage. Kies bij Enable for shipping methods de verzendmethoden of tarieven waarbij COD beschikbaar mag blijven en sla de instellingen op. Zo heb je geen PHP nodig als deze methoden specifiek zijn voor de bedoelde gebieden. Met deze instelling kies je niet rechtstreeks een verzendzone-ID. Daarom is ze mogelijk niet geschikt wanneer dezelfde verzendmethode zowel in toegestane als in uitgesloten zones wordt aangeboden. Zie de WooCommerce-instructies voor Cash on Delivery.

Wil je een betaalmethode op basis van één exacte zone beperken, houd er dan rekening mee dat WooCommerce het verzendadres koppelt aan de eerste overeenkomende verzendzone. Plaats specifiekere zones boven bredere zones, zoals uitgelegd in de documentatie over verzendzones. Via de standaardinstellingen kun je betaalmethoden niet rechtstreeks aan een zone koppelen.

  1. Ga naar WooCommerce → Settings → Shipping → Shipping zones. Bewerk de zone die je wilt beperken en noteer het getal bij zone_id in de beheer-URL. Een zone-ID duidt het bezorggebied aan en is niet hetzelfde als de instantie-ID van een verzendmethode.
  2. Bepaal onder WooCommerce → Settings → Payments welke betaalmethode je wilt verbergen. Het PHP-filter gebruikt de interne gateway-ID, niet de zichtbare naam bij het afrekenen.

De ingebouwde offline betaalmethoden van WooCommerce gebruiken deze gateway-ID's:

Betaalmethode Gateway-ID
Cash on Delivery cod
Direct Bank Transfer bacs
Check Payments cheque

Controleer bij extensies zoals Stripe, PayPal of WooPayments eerst de interne gateway-ID in de documentatie of broncode van die extensie.

De betaalmethode voor die zone verbergen

Maak een back-up en test de wijziging op een testkopie van je winkel. Voeg het volgende fragment toe binnen de bestaande PHP-code in functions.php van je actieve childtheme, zonder een extra <?php-tag. Volg de instructies voor childthemes van HoverCraft om het hoofdthema niet te hoeven bewerken. Vervang 3 door de zone-ID, cod door de interne gateway-ID en myshop op beide plaatsen door een prefix die uniek is voor je site.

function myshop_hide_gateway_by_zone( $gateways ) {
	if ( ! function_exists( 'WC' ) || ! WC()->cart || ! class_exists( 'WC_Shipping_Zones' ) ) {
		return $gateways;
	}

	foreach ( WC()->cart->get_shipping_packages() as $package ) {
		$zone = WC_Shipping_Zones::get_zone_matching_package( $package );

		if ( (int) $zone->get_id() === 3 ) {
			unset( $gateways['cod'] );
			break;
		}
	}

	return $gateways;
}
add_filter( 'woocommerce_available_payment_gateways', 'myshop_hide_gateway_by_zone', 20 );

Het filter woocommerce_available_payment_gateways controleert elk verzendpakket met de WooCommerce-API voor verzendzones. Komt één pakket overeen met zone 3, dan wordt cod voor het hele afrekenproces verborgen, niet alleen voor dat pakket. Winkelwagens met uitsluitend virtuele producten hebben mogelijk geen verzendpakketten; deze code beperkt zulke bestellingen dus niet. Houd bij winkels met meerdere verzendpakketten rekening met deze werking voor de volledige bestelling.

Test de beperking tijdens het afrekenen

  1. Voeg een verzendbaar product toe aan de winkelwagen. Vul een adres in de beperkte zone in en controleer of de gekozen betaalmethode verdwijnt nadat het afrekenen is bijgewerkt.
  2. Gebruik daarna een adres in een andere zone. De betaalmethode hoort beschikbaar te blijven als de gewone WooCommerce-instellingen dat toestaan. Controleer bij een afwijkend resultaat welke zone als eerste overeenkomt.
  3. Test als gast en als ingelogde klant en zorg dat er minstens één bruikbare betaalmethode overblijft. Verkoop je uitsluitend virtuele producten of gebruik je meerdere verzendpakketten, test die situaties dan afzonderlijk.

Het PHP-filter woocommerce_available_payment_gateways kan betaalopties verbergen in zowel de klassieke checkout als het Checkout Block. In de bijgewerkte WooCommerce-instructies voor het Checkout Block wordt bevestigd dat het verwijderen van een gateway met PHP werkt. De compatibiliteitstabel voor hooks noemt het filter nog steeds gedeeltelijk ondersteund, omdat andere aanpassingen aan gateways aanvullende blokintegratie kunnen vereisen. Extra JavaScript is doorgaans niet nodig om alleen een gateway te verwijderen, maar test je eigen betaalextensie en afrekenindeling.

Als de beperking niet werkt

In plaats daarvan een beperkingsplugin gebruiken

Met de WooCommerce-extensie Conditional Shipping and Payments kun je beperkingen instellen onder WooCommerce → Settings → Restrictions → Payment Gateways. Kies de betaalmethode bij Exclude Gateways en voeg voorwaarden toe, zoals Shipping Method of de verzendbestemming.

Die voorwaarden vergelijken niet rechtstreeks een numerieke verzendzone-ID. Een voorwaarde op Shipping Method kan geschikt zijn als die methode uitsluitend in de bedoelde zone voorkomt. Gebruik anders het PHP-voorbeeld voor een exacte vergelijking met de zone-ID. Controleer de compatibiliteit van de extensie met je afrekenpagina en betaalmethode voordat je de beperking toepast op echte bestellingen.