WooCommerce Currency Switcher Documentation

Table of Contents

How to configure payment gateways based on currency and product-specific settings

Overview

The plugin provides two ways to control which payment gateways are available to your customers:

  1. Currency-based Gateway Restrictions: Control which payment gateways are available for each currency
  2. Product-specific Gateway Restrictions: Control which payment gateways are available for specific products

These features can be used independently or together, with product-specific settings taking precedence over currency-based settings.

Currency-based Gateway Restrictions

This feature allows you to specify which payment gateways are available for each currency. This is useful when certain payment providers only support specific currencies.

How to Set Up Currency-based Gateway Restrictions

  1. Go to WooCommerce > Settings > Currency Switcher
  2. In the “Currency Settings” section, select the currencies you want to support
  3. Go to the “Gateway Currency” tab
  4. For each payment gateway:
  • Select the currencies in which this gateway should be available
  • Leave currencies unselected to disable the gateway for those currencies

Example

Let’s say you want to:

  • Allow PayPal only for USD and EUR
  • Allow Stripe for all currencies
  • Allow Global Payments only for EUR and GBP

You would:

  1. Select USD and EUR for PayPal
  2. Select all currencies for Stripe
  3. Select EUR and GBP for Global Payments

Product-specific Gateway Restrictions

This feature allows you to specify which payment gateways are available for specific products. This is useful when:

  • Certain products can only be purchased through specific payment methods
  • You want to offer different payment options for different types of products
  • You need to restrict payment methods based on product categories or types

How to Set Up Product-specific Gateway Restrictions

  1. Edit any product in your store
  2. Go to the “Payment Gateways” tab
  3. Select the payment gateways that should be available for this product
  4. Leave all gateways unselected to allow all gateways for this product

Example

Let’s say you have:

  • Product A: Only allow PayPal
  • Product B: Only allow Stripe
  • Product C: Allow all payment gateways

You would:

  1. For Product A: Select only PayPal
  2. For Product B: Select only Stripe
  3. For Product C: Leave all gateways unselected

How the Features Work Together

When both features are configured, the plugin follows these rules:

  1. Product-specific Settings Take Precedence
  • If a product has specific gateway restrictions, only those gateways will be available for that product
  • Currency-based settings are ignored for products with specific gateway restrictions
  1. Currency-based Settings Apply When No Product-specific Settings Exist
  • For products without specific gateway restrictions, the currency-based settings determine which gateways are available
  • The current currency must be enabled for the gateway in the currency settings
  1. Cart Rules
  • When multiple products are in the cart, only the gateways that are allowed for ALL products in the cart will be shown
  • This ensures consistency in payment options across the entire order

Example Scenarios

Scenario 1: Product-specific Settings Override Currency Settings
  • Product A: Only allows PayPal
  • PayPal is disabled for EUR in currency settings
  • When viewing Product A in EUR:
  • PayPal will be available (product-specific setting takes precedence)
  • Other gateways enabled for EUR will not be shown
Scenario 2: Multiple Products in Cart
  • Product A: Only allows PayPal
  • Product B: Only allows Stripe
  • When both products are in cart:
  • No payment gateways will be shown (no common gateways)
  • Customer must remove one product to proceed with payment
Scenario 3: Mixed Settings
  • Product A: No specific gateway restrictions
  • Product B: Only allows PayPal
  • PayPal is disabled for EUR in currency settings
  • When viewing Product A in EUR:
  • PayPal will not be available (currency setting applies)
  • Other gateways enabled for EUR will be shown
  • When viewing Product B in EUR:
  • PayPal will be available (product-specific setting takes precedence)
  • Other gateways will not be shown

Best Practices

  1. Plan Your Gateway Strategy
  • Consider which payment methods make sense for each product
  • Consider which currencies each payment provider supports
  • Document your gateway restrictions for future reference
  1. Test Different Scenarios
  • Test with different currencies
  • Test with different product combinations in cart
  • Test with both logged-in and guest users
  1. Monitor Payment Issues
  • Keep track of any payment-related issues
  • Adjust gateway restrictions if customers report problems
  • Consider adding explanatory notes for restricted payment methods
  1. Regular Review
  • Periodically review your gateway settings
  • Update settings when adding new payment providers
  • Update settings when adding new products

Troubleshooting

If payment gateways are not showing as expected:

  1. Check Product Settings
  • Verify the product has the correct gateway restrictions
  • Check if multiple products in cart have conflicting restrictions
  1. Check Currency Settings
  • Verify the current currency is enabled for the desired gateway
  • Check if the currency is supported by the payment provider
  1. Check Cart Contents
  • Ensure all products in cart have compatible gateway restrictions
  • Try removing products one by one to identify conflicts
  1. Check Payment Provider Settings
  • Verify the payment provider is properly configured in WooCommerce
  • Check if the payment provider supports the current currency