WooCommerce: автоматическое отключение неактивных способов оплаты по геолокации

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

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

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

Как определить текущие способы оплаты и геолокацию пользователя

WooCommerce использует функцию WC_Geolocation::geolocate_ip() для определения местоположения пользователя по IP. Способы оплаты доступны через WC()->payment_gateways()->get_available_payment_gateways().

Для отладки можно вывести текущую страну и доступные способы оплаты на этапе оформления заказа:

add_action('woocommerce_before_checkout_form', function() {
    $location = WC_Geolocation::geolocate_ip();
    echo '<p>Detected country: ' . esc_html($location['country']) . '</p>';

    $gateways = WC()->payment_gateways()->get_available_payment_gateways();
    echo '<ul>';
    foreach ($gateways as $gateway) {
        echo '<li>' . esc_html($gateway->get_title()) . '</li>';
    }
    echo '</ul>';
});

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

Реализуем фильтр woocommerce_available_payment_gateways, который исключает из списка способы оплаты, недоступные для страны покупателя.

Основные шаги:

• Определить страну пользователя через WC_Geolocation::geolocate_ip().
• Задать массив соответствия стран и отключаемых способов оплаты.
• Отфильтровать доступные методы оплаты.

Пример кода для файла functions.php темы или собственного плагина:

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

    $location = WC_Geolocation::geolocate_ip();
    $country = $location['country'] ?? '';

    // Настройка: ключ - страна, значение - массив ID способов оплаты для отключения
    $disable_for_countries = [
        'RU' => ['cod', 'bacs'], // Пример: в России отключаем наложенный платеж и банковский перевод
        'UA' => ['cheque'],      // В Украине отключаем оплату чеком
        // Добавьте свои страны и методы
    ];

    if (isset($disable_for_countries[$country])) {
        foreach ($disable_for_countries[$country] as $disabled_gateway_id) {
            if (isset($gateways[$disabled_gateway_id])) {
                unset($gateways[$disabled_gateway_id]);
            }
        }
    }

    return $gateways;
});

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

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

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

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

• Отсутствие результата для теста: Возможно, кеширование страниц или кэш плагина мешает обновлению списка. Очистите кеш и отключите его временно.
• Неверная страна пользователя: Проверьте правильность работы WC_Geolocation::geolocate_ip(). Иногда IP могут определяться некорректно, используйте VPN для теста.
• Способы оплаты не отключаются: Убедитесь, что ID способов оплаты в массиве совпадают с фактическими (узнать ID можно в настройках WooCommerce или через var_dump).
• Отключение в админке: Фильтр должен игнорировать админку с помощью is_admin(), иначе администраторы не смогут редактировать заказы.

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

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

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