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

Почему отключение платежных систем по геолокации важно

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

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

Первым шагом нужно определить:

• Какие платежные методы должны быть отключены для каких стран или регионов.
• Как определяется геолокация пользователя (IP, billing/shipping country).
• Нужно ли учитывать разные сценарии (например, гость/зарегистрированный пользователь, разные адреса доставки и оплаты).

Например, отключить paypal для России (RU) и cod (оплата при получении) для зарубежных клиентов.

Пошаговое решение: реализация отключения с помощью хука woocommerce_available_payment_gateways

Используем хук woocommerce_available_payment_gateways, который фильтрует список доступных способов оплаты на этапе оформления заказа.

1. Получение страны клиента

Для определения страны можно использовать billing country из данных заказа или адреса пользователя в сессии WC:

function get_customer_country() {
    if ( is_admin() ) {
        return '';
    }
    $country = '';
    // Сначала пробуем получить из сессии WC
    if ( WC()->customer ) {
        $country = WC()->customer->get_billing_country();
    }
    // Если нет, можно попытаться получить из IP (через geoip-библиотеку или сервис), но это сложнее
    return $country;
}

2. Фильтрация платежных систем

Вешаем функцию на фильтр и отключаем требуемые методы:

add_filter( 'woocommerce_available_payment_gateways', 'disable_payment_gateways_by_geo' );
function disable_payment_gateways_by_geo( $available_gateways ) {
    $country = get_customer_country();

    if ( ! $country ) {
        return $available_gateways; // не можем определить страну
    }

    // Пример: отключаем PayPal для России
    if ( $country === 'RU' && isset( $available_gateways['paypal'] ) ) {
        unset( $available_gateways['paypal'] );
    }

    // Отключаем оплату при доставке (cod) для всех, кроме России
    if ( $country !== 'RU' && isset( $available_gateways['cod'] ) ) {
        unset( $available_gateways['cod'] );
    }

    return $available_gateways;
}

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

• Откройте страницу оформления заказа.
• Измените адрес оплаты на страну, для которой нужно отключить платежные системы.
• Убедитесь, что соответствующий способ оплаты исчезает из списка.
• Проверьте, что для других стран эти методы по-прежнему доступны.

Для более точного тестирования можно использовать VPN или подменять IP, если вы реализовали определение страны по IP.

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

• Страна не определяется: WC()->customer может быть пустым, если пользователь не начал оформление заказа. Проверьте, что код выполняется на странице оформления.
• Методы оплаты не скрываются: Возможно, ID платежных шлюзов указаны неправильно. Проверьте правильность ключей, например paypal, cod, через print_r( $available_gateways ).
• Кэширование мешает обновлению списка: Если на сайте активно кэширование, очистите кэш или исключите страницу оформления из кэширования.
• Различия между billing и shipping country: Иногда стоит использовать get_shipping_country() в зависимости от логики.

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

• Не используйте сторонние API для геолокации на каждом запросе оформления заказа — это замедлит процесс и создаст нагрузку. Лучше использовать локальные решения или WC встроенный геолокатор.
• Кэшируйте результаты определения страны в сессии пользователя, чтобы не выполнять операции повторно.
• Обязательно проверяйте правильность ключей платежных шлюзов — при обновлении WooCommerce они могут измениться.
• Тестируйте на staging-сайте перед внедрением на боевом.

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