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

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

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

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

Как определить, что в вашем магазине есть проблема

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

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

1. Включение геолокации WooCommerce

Перейдите в WooCommerce > Настройки > Общие и в разделе "Определение местоположения клиента" выберите Геолокация с поддержкой кеша (Geolocate with page caching support). Это позволит WooCommerce узнавать страну пользователя.

2. Добавление кода для отключения способов оплаты

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

add_filter('woocommerce_available_payment_gateways', 'disable_payment_gateways_by_geolocation');
function disable_payment_gateways_by_geolocation($available_gateways) {
    if (is_admin()) return $available_gateways; // не трогаем админку

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

    // Пример: отключаем 'cod' и 'bacs' для клиентов из России (RU)
    if ($user_country === 'RU') {
        unset($available_gateways['cod']); // Наложенный платёж
        unset($available_gateways['bacs']); // Банковский перевод
    }

    // Можно добавить другие страны и способы оплаты по аналогии

    return $available_gateways;
}

В этом примере при заходе пользователя из России отключаются способы оплаты «Наложенный платёж» и «Банковский перевод».

3. Тестирование решения

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

Как проверить, что решение сработало

• На странице оформления заказа в зависимости от IP-геолокации должно меняться доступное множество способов оплаты.
• Включите отладку WooCommerce (в wp-config.php добавить define('WP_DEBUG', true);) и проверьте логи на предмет ошибок.
• Попросите коллег или воспользуйтесь инструментами онлайн проверки IP, чтобы убедиться, что геолокация работает корректно.

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

• Способы оплаты не отключаются
  Проверьте, что вы используете правильные идентификаторы способов оплаты. Их можно узнать в WooCommerce > Настройки > Оплата, нажав на способ и посмотрев URL (параметр id), либо в коде плагина.
• Геолокация не работает или показывает неправильную страну
  Убедитесь, что в настройках WooCommerce включена геолокация и что IP клиента корректно определён. Иногда сервер или прокси могут влиять на результат.
• Кэширование мешает отображению актуальных способов оплаты
  Если сайт использует агрессивный кэш (например, Varnish или плагин кеширования), то геолокация может работать неправильно. Используйте режим «Геолокация с поддержкой кеша» и убедитесь, что страницы оформления заказа исключены из кэширования.

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

• Не добавляйте слишком много условий внутри фильтра woocommerce_available_payment_gateways, чтобы не замедлять загрузку страницы оформления заказа.
• Храните списки стран и отключаемых способов оплаты в настройках плагина или темы, чтобы не менять код напрямую.
• Используйте WP Cron для периодической проверки и обновления настроек, если способы оплаты меняются часто.
• Для дополнительной безопасности ограничьте доступ к административным настройкам и к коду, который меняет платежные шлюзы.

Сравнение способов реализации