Почему в WooCommerce не работает обновление статуса заказа при оплате и как исправить

Диагностика проблемы: заказ не меняет статус после оплаты

В WooCommerce распространённая ситуация — заказ оплачен, но статус в админке остаётся прежним, например, «в ожидании оплаты» или «обработка». Это мешает автоматизировать обработку заказов и информирование клиентов.

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

• Корректно ли настроен платежный шлюз и возвращает ли он подтверждение оплаты WooCommerce.
• Нет ли конфликтов с плагинами, которые могут блокировать смену статуса.
• Правильно ли задана связка между успешной оплатой и сменой статуса в настройках WooCommerce и в коде шлюза.
• Логируются ли ошибки при попытке смены статуса.

Как проверить работу смены статуса

Добавьте временный код для логирования смены статуса, например в functions.php темы или подключаемого плагина:

add_action('woocommerce_order_status_changed', function($order_id, $old_status, $new_status, $order) {
    error_log("Order #$order_id status changed from $old_status to $new_status");
}, 10, 4);

После оформления тестового заказа проверьте файл логов сервера (обычно error_log) на предмет появления записи. Если запись отсутствует, значит событие смены статуса не срабатывает.

Пошаговое решение проблемы обновления статуса заказа

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

Убедитесь, что используемый шлюз правильно возвращает подтверждение оплаты. Для этого:

• Проверьте документацию вашего платежного модуля — есть ли там инструкции по активации вебхуков или callback URL.
• Настройте вебхук в личном кабинете платежной системы на URL https://example.com/?wc-api=название_шлюза (замените example.com и название_шлюза).
• Проверьте наличие GET-параметров order_id и payment_status в запросах от шлюза.

2. Отключение конфликтующих плагинов

Для проверки конфликтов:

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

3. Принудительное обновление статуса через хук

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

add_action('woocommerce_thankyou', 'custom_update_order_status_after_payment');
function custom_update_order_status_after_payment($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if ($order->get_status() === 'pending') {
        // Проверяем, что оплата прошла
        if ($order->is_paid()) {
            $order->update_status('processing', 'Статус автоматически обновлен после оплаты.');
            error_log("Order #$order_id статус обновлен на processing после оплаты");
        }
    }
}

Этот код срабатывает на странице благодарности после оплаты и переводит заказ из статуса pending в processing.

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

Для проверки:

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

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

• Отсутствие настроенного вебхука в платежной системе. Без него WooCommerce не получает подтверждение оплаты. Решение: настроить вебхук с правильным URL.
• Конфликт с кэшированием. Если сайт использует кэш, webhook-запросы могут блокироваться. Решение: добавить исключения для URL webhook в настройках кэша.
• Неправильные права доступа к файлам. Вебхук не может вызвать код, если файлы недоступны. Проверьте права на директории и файлы.
• Пользовательские фильтры, блокирующие смену статуса. Иногда кастомный код в functions.php или плагинах может отменять смену статуса. Решение: временно отключить кастомные фильтры / действия и проверить.

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

• Используйте HTTPS для callback URL платежных шлюзов.
• Проверяйте подписи и токены в webhook запросах для исключения подделок.
• Логируйте только критичные ошибки, чтобы не засорять логи.
• Добавляйте проверку nonce и прав пользователя, если меняете статусы заказов через пользовательский интерфейс.
• Для масштабных сайтов с большим количеством заказов используйте асинхронную обработку webhook через очередь задач (например, через Action Scheduler в WooCommerce).

Сравнение вариантов решения

Метод	Преимущества	Недостатки
Настройка вебхука платежного шлюза	Автоматично, официально, надежно	Зависит от правильной настройки и поддержки шлюза
Отключение конфликтующих плагинов	Выявляет источник проблемы	Требует времени, может быть сложно на живом сайте
Принудительное обновление статуса кодом	Простая реализация, работает без изменения настроек шлюза	Может не учитывать все нюансы оплаты, риск неверного статуса