Решение проблемы с SSL при работе WooCommerce Webhooks в WordPress

Автор: Елена Журавлева | Опубликовано: 10.05.2026

Диагностика проблемы с SSL в WooCommerce Webhooks

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

Для диагностики выполните следующие шаги:

Проверьте логи WooCommerce: WooCommerce > Статус > Логи, выберите лог webhook и найдите ошибки SSL.
Используйте curl из командной строки на сервере для проверки SSL-цепочки: curl -Iv https://example.com/webhook-endpoint.
Запустите тест SSL с помощью онлайн-сервисов: SSL Labs https://www.ssllabs.com/ssltest/ или openssl s_client -connect example.com:443.

Распространённые симптомы

Webhook не срабатывает, статус в WooCommerce — «Ошибка».
В логах ошибки вида: SSL certificate problem: unable to get local issuer certificate.
Таймауты соединения с SSL-сервером.

Пошаговое решение проблемы SSL для WooCommerce Webhooks

1. Проверка и обновление SSL-сертификата

Убедитесь, что сертификат корректно установлен и включает весь цепочку сертификатов (intermediate CA). Неполная цепочка вызывает ошибки.

Если используете Let's Encrypt, убедитесь, что сервер автоматически обновляет сертификат и цепочку.

2. Обновление корневых сертификатов на сервере

WooCommerce Webhooks отправляются на вашем сервере через PHP, используя cURL или WP HTTP API. Если корневые сертификаты устарели, SSL-проверка не пройдет.

Обновите пакет CA сертификатов (на Debian/Ubuntu):

sudo apt-get update && sudo apt-get install --only-upgrade ca-certificates

Или на CentOS/RHEL:

sudo yum update ca-certificates

3. Принудительное указание пути к CA в PHP

Если по-прежнему возникает ошибка, явно задайте путь к файлу CA в PHP cURL, например, в functions.php темы или в плагине:

add_filter('http_api_curl', function($handle) {
    curl_setopt($handle, CURLOPT_CAINFO, '/etc/ssl/certs/ca-bundle.crt');
    return $handle;
});

Путь /etc/ssl/certs/ca-bundle.crt поменяйте под вашу систему.

4. Проверка конфигурации webhook URL

Убедитесь, что URL вебхука начинается с https:// и ведет на корректный endpoint, доступный с сервера.

Проверьте доступность с сервера командой:

curl -v https://example.com/webhook-endpoint

5. Отключение проверки SSL (только для теста!)

Для локальной диагностики временно можно отключить проверку SSL:

add_filter('http_request_args', function($r, $url) {
    if (strpos($url, 'example.com/webhook-endpoint') !== false) {
        $r['sslverify'] = false;
    }
    return $r;
}, 10, 2);

Это временный шаг, в продакшене отключать нельзя!

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

Отправьте тестовый webhook из WooCommerce: WooCommerce > Настройки > Продвинутые > Webhooks > Отправить тест.
Проверьте логи на отсутствие ошибок SSL.
Убедитесь, что обработчик webhook получает данные и успешно обрабатывает их.
Запустите curl с сервера для проверки доступности endpoint.

Частые ошибки и способы их устранения

Неверный путь к CA bundle в PHP: проверьте, что путь в CURLOPT_CAINFO существует и доступен.
Отсутствие промежуточных сертификатов: используйте SSL Labs для проверки цепочки и исправьте конфигурацию сервера.
Проблемы с DNS или firewall: сервер может не видеть webhook URL — проверьте доступность с сервера.
Кеширование webhook: иногда плагины кеширования блокируют вызовы; отключите кеширование для webhook URL.

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

Не отключайте проверку SSL в продакшене — это уязвимость.
Используйте последние версии PHP и OpenSSL для актуальной поддержки шифров.
Оптимизируйте endpoint webhook, чтобы он быстро отвечал и не вызывал таймаутов.
Рассмотрите использование WPShop Clearfy для очистки и оптимизации сайта, что может повысить стабильность работы API и вебхуков (https://wpshop.ru/plugins/clearfy).

Сравнение способов решения проблемы SSL в WooCommerce Webhooks

Способ	Плюсы	Минусы
Обновление сертификатов сервера	Надёжное и безопасное решение, устраняет корень проблемы	Требует доступа к серверу и времени на обновление
Принудительная установка CA в PHP	Быстро решает проблему для конкретного сайта	Зависит от правильности пути, требует поддержки при обновлениях
Отключение SSL-проверки (временное)	Позволяет диагностировать проблему	Уязвимый способ, нельзя использовать в продакшене