WooCommerce: устранение проблемы отсутствия подтверждения платежа при оплате картой

Диагностика проблемы отсутствия подтверждения платежа

Основная причина, по которой WooCommerce не получает подтверждение платежа при оплате картой — это сбой в коммуникации между платежным шлюзом и сайтом. Например, при использовании сторонних платежных систем (Stripe, PayPal, Яндекс.Касса и др.) подтверждение транзакции приходит через вебхуки или callback URL, которые могут быть заблокированы сервером, неправильно настроены или не доходят из-за ошибок в коде.

Также распространена ситуация, когда платеж прошёл, но статус заказа в WooCommerce не меняется на «Оплачен» или «Завершён», что блокирует дальнейшую обработку заказа.

Как проверить, что именно не работает

• Проверить логи вебхуков в панели платежной системы (если доступно).
• Проверить логи WooCommerce или сайта на предмет ошибок при обработке callback-запросов.
• Убедиться, что URL для обратного вызова (webhook/callback) корректно прописан и доступен из интернета.
• Проверить, не блокирует ли сервер/хостинг POST-запросы по URL callback.
• Проверить, что SSL-сертификат корректен — многие шлюзы требуют https.

Пошаговое решение проблемы с подтверждением платежа

1. Проверка и настройка webhook URL в платежном шлюзе

В панели управления платежного шлюза найдите раздел webhook или callback и убедитесь, что указанный URL совпадает с адресом, который ожидает WooCommerce. Обычно URL выглядит так:

https://example.com/?wc-api=wc_gateway_{gateway_id}

Пример для Stripe:

https://example.com/?wc-api=wc_stripe

Если URL не совпадает или отсутствует, добавьте его.

2. Проверка доступности URL обратного вызова

Для проверки используйте curl или онлайн-инструменты, например:

curl -I https://example.com/?wc-api=wc_gateway_stripe

Ответ должен быть 200 OK. Если статус 404 или 403 — исправьте настройки сервера, .htaccess или защитные плагины.

3. Включение и анализ логов WooCommerce

В WooCommerce перейдите в WooCommerce > Настройки > Платежи > Ваш шлюз > Логи и включите логирование. После попытки оплаты проверьте логи в wp-content/uploads/wc-logs/.

4. Добавление кода для отладки webhook

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

add_action('woocommerce_api_wc_gateway_custom', 'debug_webhook_callback');
function debug_webhook_callback() {
    $input = file_get_contents('php://input');
    error_log('Webhook received: ' . $input);
    http_response_code(200);
    exit;
}

Замените wc_gateway_custom на ID вашего шлюза.

5. Проверка SSL и правил безопасности

Убедитесь, что ваш сайт использует валидный SSL-сертификат. Проверьте настройки firewall и плагинов безопасности (Wordfence, iThemes Security), которые могут блокировать внешние запросы.

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

• Сделайте тестовую оплату картой через платежный шлюз в тестовом режиме.
• Проверьте, что статус заказа изменился на "Обработан" или "Завершён" автоматически.
• Посмотрите логи WooCommerce для подтверждения успешного приема webhook.
• Проверьте, что на стороне платежного шлюза webhook delivery отмечен как успешный.

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

• Неправильный webhook URL. Часто URL меняется при смене домена или протокола (http/https). Проверьте и обновите URL в настройках шлюза.
• Блокировка POST-запросов сервером. Проверьте конфигурацию .htaccess, mod_security и firewall. Временно отключите защиту для теста.
• Проблемы с SSL. Старые или самоподписанные сертификаты отклоняются шлюзами. Используйте Let's Encrypt или проверенный сертификат.
• Ошибки в коде обработчика webhook. Проверьте, что PHP-скрипт возвращает ответ 200 и корректно обрабатывает данные.
• Плагины кеширования или CDN. Иногда кешируют webhook URL. Исключите этот URL из кеширования.

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

• Используйте отдельный endpoint для webhook, чтобы минимизировать риски атак.
• Проверяйте подписи webhook (если поддерживается платежным шлюзом) для подтверждения подлинности запросов.
• Отключайте лишние плагины на страницах callback, чтобы ускорить обработку и избежать конфликтов.
• Добавьте лимит времени выполнения для webhook-обработчика, чтобы избежать зависаний.
• Всегда ведите логи ошибок и успешных запросов — это поможет быстро диагностировать проблемы.

Таблица сравнения способов решения проблемы