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

Когда и зачем отключать платёжные системы в WooCommerce?

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

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

Для выбора условий отключения обычно смотрят на:

• Сумму корзины (минимальная/максимальная)
• Тип товаров в корзине (категория, теги, конкретные товары)
• Данные пользователя (роль, страна доставки/оплаты)
• Способы доставки
• Промокоды или купоны

Если вы замечаете, что какой-то метод оплаты доступен, когда не должен, проверьте фильтры и хуки, которые могут влиять на available_payment_gateways в WooCommerce.

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

Для управления доступностью платёжных шлюзов используется фильтр woocommerce_available_payment_gateways. Ниже пример кода, который отключает оплату «наличными» при сумме заказа больше 5000 рублей, а PayPal — для товаров из категории «электроника».

add_filter('woocommerce_available_payment_gateways', 'custom_disable_payment_gateways_by_conditions', 10, 1);
function custom_disable_payment_gateways_by_conditions($available_gateways) {
    if (!is_checkout()) return $available_gateways;

    $cart_total = WC()->cart->get_total('edit');
    $cart_total = floatval(str_replace(',', '', $cart_total));

    // Отключаем оплату наличными при сумме более 5000
    if ($cart_total > 5000 && isset($available_gateways['cod'])) {
        unset($available_gateways['cod']);
    }

    // Проверяем товары в корзине по категории
    $disable_paypal = false;
    foreach (WC()->cart->get_cart() as $cart_item) {
        $product_id = $cart_item['product_id'];
        if (has_term('elektronika', 'product_cat', $product_id)) {
            $disable_paypal = true;
            break;
        }
    }
    if ($disable_paypal && isset($available_gateways['paypal'])) {
        unset($available_gateways['paypal']);
    }

    return $available_gateways;
}

Обратите внимание, что ключи платёжных шлюзов (cod, paypal) зависят от используемых плагинов и настроек. Их можно узнать через отладку массива $available_gateways.

Как узнать ключи платёжных шлюзов

Добавьте временно в functions.php или в плагин следующий код, чтобы вывести все доступные методы оплаты на странице оформления заказа:

add_action('woocommerce_before_checkout_form', 'debug_payment_gateways');
function debug_payment_gateways() {
    $gateways = WC()->payment_gateways()->get_available_payment_gateways();
    echo '<pre>';
    print_r(array_keys($gateways));
    echo '</pre>';
}

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

Чтобы проверить, что условное отключение работает:

1. Добавьте в корзину товары с разной категорией (например, из «электроника» и из других).
2. Установите сумму корзины ниже и выше 5000 рублей.
3. Перейдите на страницу оформления заказа и убедитесь, что нужные методы оплаты отображаются или скрываются в соответствии с правилами.
4. Используйте вывод print_r для проверки массива доступных методов оплаты в коде.

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

• Неправильный ключ платёжного шлюза: Плагины могут использовать свои ID. Обязательно проверьте ключи через отладку.
• Кэширование страницы оформления заказа: Иногда кэш мешает обновлению методов оплаты. Отключите кэширование для страницы Checkout или очистите кэш.
• Использование get_total() с форматированием: Функция возвращает строку с валютой и разделителями, поэтому обязательно приводите к числу, иначе условия не сработают.
• Условия проверяются вне страницы оформления заказа: Фильтр срабатывает и на других страницах, добавляйте проверку is_checkout().

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

• Не храните чувствительные данные в сессии без шифрования.
• Минимизируйте сложность условий, чтобы не замедлять загрузку страницы оформления заказа.
• Используйте transient API для кэширования результатов проверки сложных условий по товарам.
• Тестируйте с отключенными плагинами кэширования и оптимизации, чтобы избежать конфликтов.

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