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

Диагностика проблемы с платежными системами по IP

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

Как реализовать автоматическое отключение платежных систем по IP в WooCommerce

Шаг 1. Получение IP-адреса клиента

Первым делом необходимо корректно получить IP клиента, учитывая варианты с прокси и CDN. Вот проверенный код для функции, которая возвращает реальный IP:

function wpedu_get_client_ip() {
    if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
        $ip = $_SERVER['HTTP_CLIENT_IP'];
    } elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $ip = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR'])[0];
    } else {
        $ip = $_SERVER['REMOTE_ADDR'];
    }
    return trim($ip);
}

Шаг 2. Создание списка запрещённых IP

Для удобства лучше хранить IP в массиве. Можно использовать CIDR-диапазоны, но для упрощения возьмём точные IP или диапазоны в формате начала и конца:

$blocked_ips = [
    '192.168.1.10',
    '203.0.113.0-203.0.113.255', // пример диапазона
];

Шаг 3. Проверка IP и фильтрация доступных методов оплаты

Добавим фильтр woocommerce_available_payment_gateways, чтобы при совпадении IP отключать нужные платежные системы. В примере отключим "cod" (наложенный платеж) и "bacs" (банковский перевод):

add_filter('woocommerce_available_payment_gateways', 'wpedu_disable_payment_gateways_by_ip');
function wpedu_disable_payment_gateways_by_ip($available_gateways) {
    $client_ip = wpedu_get_client_ip();
    $blocked_ips = [
        '192.168.1.10',
        '203.0.113.0-203.0.113.255',
    ];

    foreach ($blocked_ips as $ip_range) {
        if (strpos($ip_range, '-') !== false) {
            list($start_ip, $end_ip) = explode('-', $ip_range);
            if (ip2long($client_ip) >= ip2long($start_ip) && ip2long($client_ip) <= ip2long($end_ip)) {
                if (isset($available_gateways['cod'])) {
                    unset($available_gateways['cod']);
                }
                if (isset($available_gateways['bacs'])) {
                    unset($available_gateways['bacs']);
                }
                break;
            }
        } elseif ($client_ip === $ip_range) {
            if (isset($available_gateways['cod'])) {
                unset($available_gateways['cod']);
            }
            if (isset($available_gateways['bacs'])) {
                unset($available_gateways['bacs']);
            }
            break;
        }
    }
    return $available_gateways;
}

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

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

• Используйте VPN или прокси с IP из списка $blocked_ips.
• Откройте страницу оформления заказа WooCommerce.
• Проверьте, что способы оплаты "наложенный платеж" и "банковский перевод" не отображаются.
• Попробуйте сменить IP на не заблокированный и убедитесь, что методы оплаты снова доступны.

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

• Неправильное получение IP клиента: Использование только $_SERVER['REMOTE_ADDR'] игнорирует прокси и CDN. Решение: используйте функцию wpedu_get_client_ip() из статьи.
• Неверный формат диапазонов IP: Если используете строки с дефисом, убедитесь, что ip2long() корректно обрабатывает их. Для сложных диапазонов лучше использовать специализированные библиотеки.
• Отключение несуществующих платежных систем: Перед unset проверяйте наличие ключа, иначе PHP выдаст предупреждение.
• Кэширование страниц или плагинов: Если на сайте включён кэш, он может показывать старые варианты оплаты. Очистите кэш после внесения изменений.

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

• Безопасность: Храните список заблокированных IP в отдельном конфигурационном файле или в настройках плагина, чтобы не редактировать код каждый раз.
• Производительность: Фильтр woocommerce_available_payment_gateways вызывается на каждом шаге оформления заказа. Минимизируйте операции внутри функции, избегайте тяжелых запросов.
• Логирование: Для отладки добавьте запись в лог, когда IP блокируется, чтобы фиксировать подозрительную активность.

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