WooCommerce: почему не прошёл автоматический апдейт статуса заказа и как исправить

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

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

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

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

Проверка вебхуков платёжного шлюза

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

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

Отладка хуков смены статуса

WooCommerce использует несколько хуков для смены статуса. Например, woocommerce_payment_complete срабатывает после успешной оплаты. Проверьте, вызывается ли этот хук в вашем случае.

Добавьте следующий код в functions.php вашей темы для отладки:

add_action('woocommerce_payment_complete', function($order_id) {
    error_log('Оплата завершена для заказа #' . $order_id);
});

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

Пошаговое решение: как восстановить автоматическое обновление статуса заказа

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

• Убедитесь, что ваш платёжный шлюз поддерживает автоматическое обновление статусов и настроен правильно.
• Проверьте URL для обратного вызова (callback URL) в настройках платёжного сервиса — он должен указывать на ваш сайт и быть доступен извне.
• Протестируйте webhook вручную через инструменты платёжного сервиса (например, Stripe Dashboard, PayPal Sandbox).

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

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

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

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

add_action('woocommerce_payment_complete', 'custom_update_order_status');
function custom_update_order_status($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Пример: сменить статус на "processing"
    if ($order->get_status() !== 'processing') {
        $order->update_status('processing', 'Статус обновлен вручную после оплаты');
    }
}

4. Проверка прав доступа и ролей

Иногда смена статуса блокируется из-за недостаточных прав пользователя или роли, под которой выполняется скрипт. Проверьте, что пользователь, от имени которого происходит обновление, имеет права на редактирование заказов.

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

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

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

• Отсутствие webhook в платёжном шлюзе. Исправьте в настройках платёжного сервиса.
• Конфликт плагинов. Используйте диагностику, отключая плагины по одному.
• Ошибка кэширования. Убедитесь, что сервер и плагины кэширования не кешируют AJAX-запросы, вебхуки или REST API.
• Проблемы с правами. Проверьте capabilities пользователя, запускающего обновление.
• Неправильные статусы. WooCommerce поддерживает определённые статусы, используйте только их.

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

• Регулярно обновляйте WooCommerce и платёжные плагины, чтобы избежать уязвимостей.
• Используйте HTTPS для всех callback URL.
• Ограничьте доступ к webhook URL по IP, если платёжный сервис поддерживает такую опцию.
• Не храните чувствительные данные в логах, используйте их только для отладки.
• Оптимизируйте логи, чтобы не засорять пространство на сервере.

Сравнение подходов обновления статуса заказа