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

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

Часто возникает задача ограничить доступность определённых платёжных систем в WooCommerce в зависимости от условий: например, по сумме заказа, выбранному региону доставки или виду товара. Это помогает избежать ошибок оплаты, снизить риски мошенничества и улучшить UX.

Типичные ситуации:

• Отключение оплаты при сумме заказа ниже минимального порога (например, предоплата недоступна для заказов ниже 1000 рублей).
• Ограничение платёжных систем по странам или регионам доставки.
• Отключение способов оплаты для определённых категорий товаров (например, нельзя оплатить наложенным платежом цифровые товары).

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

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

Пример кода для отключения способа оплаты "cod" (наложенный платёж) при сумме заказа меньше 1500 рублей:

add_filter('woocommerce_available_payment_gateways', 'disable_cod_for_small_orders');
function disable_cod_for_small_orders($available_gateways) {
    if (!is_checkout()) {
        return $available_gateways;
    }
    $minimum_amount = 1500;
    if (WC()->cart->total < $minimum_amount) {
        if (isset($available_gateways['cod'])) {
            unset($available_gateways['cod']);
        }
    }
    return $available_gateways;
}

Чтобы ограничить способы оплаты по региону доставки (например, отключить PayPal для региона Москва):

add_filter('woocommerce_available_payment_gateways', 'disable_paypal_for_moscow');
function disable_paypal_for_moscow($available_gateways) {
    if (!is_checkout()) {
        return $available_gateways;
    }
    $chosen_shipping = WC()->session->get('chosen_shipping_methods');
    $chosen_shipping = is_array($chosen_shipping) ? $chosen_shipping[0] : '';
    $shipping_packages = WC()->shipping->get_packages();
    $shipping_city = '';
    if (!empty($shipping_packages[0]['destination']['city'])) {
        $shipping_city = strtolower($shipping_packages[0]['destination']['city']);
    }
    if ($shipping_city === 'москва') {
        if (isset($available_gateways['paypal'])) {
            unset($available_gateways['paypal']);
        }
    }
    return $available_gateways;
}

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

• Добавьте товар в корзину с разным итогом суммы и проверьте список доступных платёжных систем на странице оформления заказа.
• Измените адрес доставки на разные города и убедитесь, что способы оплаты появляются или исчезают в соответствии с логикой.
• Для дополнительной диагностики можно временно добавить error_log() с выводом текущих условий.

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

• Функция срабатывает не всегда: Убедитесь, что код находится в файле темы (functions.php) или в плагине и что он подключается до загрузки страницы оформления заказа.
• Неверные ключи платёжных систем: Для корректного отключения используйте точные ID из массива $available_gateways. Их можно вывести с помощью error_log(print_r($available_gateways, true));.
• Проблемы с кешированием: Если есть кеш-решения (например, Object Cache или плагин кеширования), отключение может не сразу отображаться. Очистите кеш после изменений.
• Не учитывается выбранный регион: Для определения региона используйте данные из WC()->customer->get_shipping_city() или WC()->shipping->get_packages(), а не $_POST напрямую, чтобы гарантировать актуальность данных.

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

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

Сравнение подходов: плагин vs код vs компромисс

Итоги и чек-лист внедрения

• Определите условия отключения платёжных систем
• Выясните ID нужных платёжных шлюзов
• Добавьте фильтр woocommerce_available_payment_gateways с вашей логикой
• Проверьте работу на тестовом оформлении заказа
• Очистите кеш сайта и браузера
• Отслеживайте логи на предмет ошибок