WooCommerce: автоматическое отключение методов оплаты по условию

Диагностика проблемы: когда нужно отключать методы оплаты автоматически

В интернет-магазинах на WooCommerce часто возникает необходимость отключить определённые способы оплаты в зависимости от различных условий: страны покупателя, суммы заказа, выбранных товаров или пользовательских ролей. Например, можно запретить оплату наложенным платежом для заказов свыше 10 000 рублей или отключить оплату картой для нерегистрационных пользователей.

Без автоматизации такие задачи решаются либо через плагины с ограниченным функционалом, либо вручную, что неудобно и приводит к ошибкам и потерям продаж.

Пошаговое решение: как отключить методы оплаты по условию

1. Использование хука woocommerce_available_payment_gateways

WooCommerce предоставляет фильтр woocommerce_available_payment_gateways, который позволяет изменить список доступных методов оплаты на этапе оформления заказа.

Пример кода для отключения оплаты «наложенным платежом» (gateway ID: cod) если сумма заказа превышает 10 000 рублей:

add_filter('woocommerce_available_payment_gateways', 'disable_payment_gateways_conditionally', 10, 1); function disable_payment_gateways_conditionally($available_gateways) {     if (!is_checkout()) {         return $available_gateways;     }      $minimum_amount = 10000;     $cart_total = WC()->cart->total;      if ($cart_total > $minimum_amount && isset($available_gateways['cod'])) {         unset($available_gateways['cod']);     }      return $available_gateways; }

2. Расширение условий: отключение по стране и роли пользователя

Добавим условие, отключающее метод оплаты «банковский перевод» (gateway ID: bacs) для пользователей из России с ролью «гость» (незарегистрированные):

add_filter('woocommerce_available_payment_gateways', 'disable_payment_gateways_by_country_and_role', 20, 1); function disable_payment_gateways_by_country_and_role($available_gateways) {     if (!is_checkout()) {         return $available_gateways;     }      $user = wp_get_current_user();     $allowed_roles = ['customer', 'subscriber']; // роли зарегистрированных пользователей      $billing_country = WC()->customer->get_billing_country();      // Отключаем банковский перевод для гостей из России     if ($billing_country === 'RU' && !array_intersect($allowed_roles, $user->roles)) {         if (isset($available_gateways['bacs'])) {             unset($available_gateways['bacs']);         }     }      return $available_gateways; }

Проверка результата после внедрения

• Очистите кэш браузера и кэш сайта (если есть кэширующие плагины).
• Добавьте товары в корзину на сумму выше 10 000 рублей и перейдите к оформлению заказа — метод «наложенный платёж» должен исчезнуть.
• Измените страну в адресе выставления счета на «Россия» и попробуйте оформить заказ под гостем — метод «банковский перевод» должен быть недоступен.
• Зарегистрируйтесь как пользователь с ролью «customer» и повторите попытку — метод оплаты должен появиться.

Частые ошибки и как их исправить

• Методы оплаты не отключаются: Проверьте правильность ID методов оплаты. Их можно узнать в WooCommerce → Настройки → Оплата.
• Код не срабатывает на странице оформления заказа: Убедитесь, что используете условие is_checkout(). Без него код может работать в других местах, что приведет к ошибкам.
• Ошибки PHP при добавлении кода: Проверьте синтаксис, используйте отладку через WP_DEBUG. Добавляйте код в дочернюю тему или плагин для снижения риска конфликтов.
• Кэш мешает обновлению методов оплаты: Очистите все виды кэша, включая серверный и браузерный.

Практические советы по безопасности и производительности

• Не размещайте код напрямую в файле functions.php основной темы, используйте дочернюю тему или отдельный плагин.
• Добавляйте проверки is_checkout() и WC()->cart для предотвращения ошибок вне контекста оформления заказа.
• Минимизируйте количество сложных условий в фильтрах, чтобы не замедлять загрузку страницы оформления.
• Для сложных сценариев используйте transient API для кэширования результатов проверок.

Сравнение способов отключения методов оплаты

Способ	Преимущества	Недостатки
Использование фильтра woocommerce_available_payment_gateways	Гибкость, точечное управление, не требует сторонних плагинов	Требует базовых знаний PHP, ошибки могут привести к недоступности оплаты
Плагины для ограничения методов платежей	Простота использования, готовые интерфейсы, поддержка	Могут быть платными, ограничены в настройках, влияют на производительность
Настройка через WooCommerce настройки (если доступно)	Интуитивно понятно, не требует кода	Ограниченный функционал, не покрывает сложные условия