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

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

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

Как определить, что метод оплаты нужно отключить

Для начала нужно чётко сформулировать условия, при которых метод оплаты должен быть недоступен. Распространённые сценарии:

• Сумма корзины ниже или выше заданного значения;
• Наличие в корзине товаров из определённых категорий или с определёнными тегами;
• Роль пользователя — отключение для гостевых или определённых ролей;
• Страна или регион доставки;
• Комбинация нескольких условий.

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

WooCommerce позволяет фильтровать доступные методы оплаты с помощью фильтра woocommerce_available_payment_gateways. Ниже приведён рабочий пример, который отключает платные методы оплаты при сумме корзины меньше 1000 рублей.

add_filter('woocommerce_available_payment_gateways', 'disable_paid_gateways_below_min_amount');
function disable_paid_gateways_below_min_amount($available_gateways) {
    if (is_admin()) return $available_gateways; // не менять методы в админке

    $min_amount = 1000; // минимальная сумма для платных методов
    $cart_total = WC()->cart->total;

    // Список методов оплаты, которые считаем платными
    $paid_methods = ['cod', 'cheque', 'bacs']; // пример: замените на реальные id ваших методов

    if ($cart_total < $min_amount) {
        foreach ($paid_methods as $method_id) {
            if (isset($available_gateways[$method_id])) {
                unset($available_gateways[$method_id]);
            }
        }
    }

    return $available_gateways;
}

В этом коде:

• $paid_methods — массив ID платных способов оплаты. Для точности проверьте ID на странице WooCommerce > Настройки > Платежи;
• Условие отключения — сумма корзины меньше 1000;
• Методы удаляются из массива доступных, и пользователь их не увидит.

Как узнать ID методов оплаты

Перейдите в WooCommerce > Настройки > Платежи и наведите на название метода — в URL будет параметр section=payment_method_id. Либо посмотрите в исходном HTML страницы оформления заказа, где применяются id методов, например payment_method_cod.

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

1. Добавьте товар в корзину с суммой ниже 1000 рублей;
2. Перейдите к оформлению заказа;
3. Проверьте, что платные методы оплаты не отображаются;
4. Увеличьте сумму корзины выше 1000 и обновите страницу — методы оплаты должны появиться.

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

• Методы оплаты не отключаются: Возможно, указан неверный ID метода. Проверьте ID через настройки WooCommerce или HTML код страницы.
• Код не срабатывает в админке: Фильтр корректно пропускает админку, чтобы не влиять на админские заказы. Это нормальное поведение.
• Условие срабатывает не для всех пользователей: Проверьте, что корзина корректно инициализирована, и фильтр не вызывается раньше загрузки корзины.
• Платные методы не отключаются для гостевых пользователей: Убедитесь, что корзина доступна и сумма правильно определяется при любом статусе пользователя.

Расширение решения: отключение по категории товаров

Чтобы отключить методы оплаты, если в корзине есть товары из определённых категорий, используйте следующий пример:

add_filter('woocommerce_available_payment_gateways', 'disable_paid_gateways_for_categories');
function disable_paid_gateways_for_categories($available_gateways) {
    if (is_admin()) return $available_gateways;

    $blocked_categories = ['vip-products', 'restricted']; // слаги категорий
    $paid_methods = ['cod', 'cheque'];

    foreach (WC()->cart->get_cart() as $cart_item) {
        $product_id = $cart_item['product_id'];
        $terms = get_the_terms($product_id, 'product_cat');
        if ($terms && !is_wp_error($terms)) {
            foreach ($terms as $term) {
                if (in_array($term->slug, $blocked_categories)) {
                    foreach ($paid_methods as $method_id) {
                        if (isset($available_gateways[$method_id])) {
                            unset($available_gateways[$method_id]);
                        }
                    }
                    return $available_gateways;
                }
            }
        }
    }

    return $available_gateways;
}

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

• Не используйте слишком сложные проверки в фильтре, чтобы не замедлять загрузку страницы оформления заказа.
• Кэширование страниц с корзиной и оформлением заказа отключайте или учитывайте динамическую генерацию доступных методов оплаты.
• Проверяйте корректность и актуальность ID методов оплаты после обновления WooCommerce и плагинов.
• Для сложных условий лучше создавать отдельные классы или сервисы, чтобы не перегружать functions.php.

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