New Woo brand announcement v2 | Feb 4, 2025

Added by Mahrie - https://woomarketingstudio.wordpress.com/2024/12/20/studio-request-logo-rollout-customer-comms/

Restrict Payment Methods

Limit the use of Payment Methods by Group Memberships, Roles, Countries and Order Amounts.

This extension allows to limit which payment methods customers can use at checkout. Restrictions can be based on group memberships, roles, countries and order amounts.

A colorful group of people, representing access to different payment methods.

Installation

↑ Back to top

You can add an extension to your store by visiting My subscriptions and following the indications after clicking Add to store for the extension. Alternatively, you can download the extension and install it as follows:

  1. Download the zip file of the extension from your WooCommerce Account. You can download an extension or under My subscriptions click the 3 vertical dots and then Download extension.
  2. On your site’s dashboard, go to Plugins > Add New Plugin and click Upload Plugin at the top.
  3. Choose the zip file of the extension and click Install Now.
  4. Activate the plugin.

Related topics: Where do I download my purchase(s)?

Requirements

↑ Back to top
  • We recommend using the latest version of WooCommerce; version 8.5 or higher is required.
  • PHP 7.4 or higher is required.
  • WordPress 6.2 or higher is required.
  • You can optionally install Groups to enable group-based payment method restrictions, version 3.0 or higher is required.

Setup

↑ Back to top

Restrictions Overview

↑ Back to top

On your site’s dashboard, head over to WooCommerce > Settings > Payments > Restrictions. You will find an overview of your available payment methods. There, you can view and manage the restrictions.

This image shows the Restrictions overview which is accessed via WooCommerce, Settings, Payments, Restrictions.

The following video provides a brief walkthrough. It gives several examples of restrictions for different payment methods. If this is your first time using the extension, we recommend watching it, as it can guide and inspire you on how to use the extension.

Managing Restrictions

↑ Back to top

To manage the restrictions for a particular payment method, simply click Manage Restrictions on the desired entry.

We are highlighting the Manage Restrictions button for a payment method shown in the Restrictions settings.

This will take you to the restriction settings for that particular payment method.

Here we see the usage restrictions that are available for a payment method.

The following settings are available:

SettingDescription
Restrict to Group MembersThis setting allows to limit the use of the payment method to members of one or several groups.

You can choose one or more groups. Only members of the chosen groups will be able to use the payment method at checkout.

Choosing the Registered group excludes guests from using the payment method.

The free Groups plugin is required for this option.
Exclude for Group MembersExclude members of one or more groups from using the payment method.

When one or more groups are chosen here, members of those groups will not be able to use the payment method at checkout.

The free Groups plugin is required for this option.
Restrict to RolesHere you can restrict the payment method to one or more roles.

If any roles are chosen, only accounts that have any of the roles can use the payment method at checkout.
Exclude for RolesThis setting allows to exclude one or more roles from using the payment method.
Restrict to Billing CountriesLimit the use of the payment method to one or more billing countries. Only orders billed to any of the chosen countries are eligible to check out with that payment method.
Exclude for Billing CountriesExclude one or more billing countries from using the payment method. Orders billed to any of the chosen countries may not use the payment method at checkout.
Minimum Order AmountIf an amount is set, it restricts the use of the payment method to require a minimum order amount.

Shipping and taxes can be excluded in the computation by checking the corresponding settings.
Maximum Order AmountIf an amount is set, it will restrict the use of the payment method to orders that do not exceed a certain order amount.

Shipping and taxes can be excluded in the computation by checking the corresponding settings.
Exclude TaxesIf enabled, order amount limits apply to the order amount excluding taxes.
Exclude ShippingIf checked, order amount limits apply to the order amount excluding shipping and shipping taxes.
DebugIf this setting is enabled, the extension will log restriction details while processing conditions for the payment method.

Debugging must be enabled for this to have an effect. See the notes below.

The setting should only be used temporarily during tests.

Combining Restrictions

If several restrictions are set, they are applied conjunctively. For example, if you restrict a payment method to members of the Registered group require the Customer role and set a minimum order amount of 50, an order placed at checkout can only use the payment method if all of those conditions are met.

Guests

You can exclude guests from using a payment method by choosing the Registered group for the “Restrict to Group Members” setting.

Caution

Normally, you would want to avoid using the same group or role for restriction and exclusion, as that will effectively make a payment method unavailable for all. For example, if you choose Customer for both “Restrict to Roles” and “Exclude for Roles” settings, nobody would be able to use the payment method.

Payments Overview

↑ Back to top

The extension adds a Restrictions column to the Payments overview available under WooCommerce > Settings > Payments > All payment methods. For standard payment methods, you can also manage the restrictions from there. Some payment solutions centralize several of their payment methods under a single entry in this view, any restrictions shown there only refer to their primary payment method. It is not convenient to manage restrictions for all of the related entries from there; you should use the detailed overview under WooCommerce > Settings > Payments > Restrictions instead.

Showing the Restrictions column in the All payment methods section.
Some payment solutions only provide a single entry in this view. Restrictions shown here only apply to their primary payment method.

Notes

↑ Back to top

WPML

↑ Back to top

The extension integrates with WPML to support currency conversion for order amount restrictions.

Debugging

↑ Back to top

During tests, it can be useful to obtain feedback from the extension when it rejects a payment method at checkout due to the restrictions that are in place. Entries are added to the log if the Debug setting is enabled for a payment method and debugging is enabled:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );

You can force logging for all payment methods by defining the constant RESTRICT_PAYMENT_METHODS_DEBUG as true in your site’s wp-config.php:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'RESTRICT_PAYMENT_METHODS_DEBUG', true );

The above should only be left in place during tests, production sites should not leave these settings enabled under day-to-day operations.

Questions and Support

↑ Back to top

Do you have a question before you decide to buy? Please let us know via this pre-sales form.

If you have already purchased the extension and need assistance, we are happy to help. Get in touch with us – choose Technical support for Restrict Payment Methods.