Как исправить ошибку «Payment gateway is not available» в WooCommerce

Диагностика проблемы: почему платежный шлюз недоступен в WooCommerce

Ошибка «Payment gateway is not available» возникает, когда выбранный метод оплаты не отображается на странице оформления заказа или недоступен для использования клиентом. Основные причины этой ошибки:

• Проблемы с настройками платежного шлюза (например, неправильный API-ключ или отключенный метод оплаты).
• Несовместимость с версией WooCommerce или WordPress.
• Конфликты с другими плагинами или темой.
• Ошибки в условных фильтрах, которые ограничивают доступ к платежному методу.
• Отсутствие поддержки для выбранной валюты или страны.

Как пошагово исправить ошибку «Payment gateway is not available»

1. Проверка основных настроек платежного шлюза

Перейдите в WooCommerce > Настройки > Платежи и убедитесь, что нужный шлюз активирован. Проверьте правильность введённых данных (API-ключи, токены).

2. Проверка активности метода оплаты для страны и валюты

Убедитесь, что метод оплаты поддерживает выбранную валюту и регион:

add_filter('woocommerce_available_payment_gateways', function($gateways) {
    if (is_checkout()) {
        $chosen_currency = get_woocommerce_currency();
        if ($chosen_currency !== 'USD') {
            unset($gateways['your_gateway_id']);
        }
    }
    return $gateways;
});

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

3. Отключение конфликтующих плагинов и смена темы

Отключите все плагины кроме WooCommerce и платежного шлюза, переключитесь на стандартную тему (например, Storefront). Если проблема исчезает, включайте плагины по одному для выявления конфликта.

4. Проверка ошибок в логах WooCommerce

Включите логирование платежного шлюза в WooCommerce > Статус > Логи. Проверьте, появляются ли ошибки при попытке оплаты.

5. Принудительная активация платежного шлюза через код

Если метод оплаты отключается из-за условий, можно добавить фильтр для проверки и принудительного включения:

add_filter('woocommerce_available_payment_gateways', function($gateways) {
    if (isset($gateways['your_gateway_id'])) {
        $gateways['your_gateway_id']->enabled = 'yes';
    }
    return $gateways;
});

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

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

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

• Метод оплаты отключён в настройках. Проверьте, активирован ли шлюз в настройках WooCommerce.
• Конфликт с другими плагинами. Используйте режим отладки, отключите плагины поочерёдно.
• Неверные API ключи или устаревший ключ. Пересоздайте ключи в панели платежного провайдера и обновите настройки.
• Метод оплаты не поддерживает выбранную валюту. Проверьте документацию платежного шлюза и настройте валюту магазина.
• Пользовательская логика фильтров скрывает метод оплаты. Проверьте все фильтры woocommerce_available_payment_gateways.

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

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

Сравнение вариантов решения проблемы