WooCommerce: автоматическое изменение статуса заказа по оплате

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

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

Основные причины проблемы:

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

Пошаговое решение: автоматизация смены статуса заказа

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

Убедитесь, что ваш платежный шлюз поддерживает отправку уведомлений о статусе платежа (например, Stripe, PayPal, Яндекс.Касса). Если нет, придется использовать ручное обновление или искать другой способ интеграции.

2. Использование хука woocommerce_payment_complete для смены статуса

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

add_action('woocommerce_payment_complete', 'custom_change_order_status_after_payment');
function custom_change_order_status_after_payment($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    // Проверяем текущий статус
    if ($order->get_status() === 'processing') {
        // Меняем статус на завершен
        $order->update_status('completed', 'Статус автоматически изменен после оплаты.');
    }
}

Этот код изменит статус заказа с processing на completed сразу после успешной оплаты. Настройте условия под свои нужды.

3. Автоматическое обновление для статуса «on-hold»

Если у вас заказы остаются в статусе on-hold, добавьте аналогичный хук:

add_action('woocommerce_order_status_on-hold_to_processing', 'custom_change_order_status_on_hold_to_processing');
function custom_change_order_status_on_hold_to_processing($order_id) {
    $order = wc_get_order($order_id);
    $order->update_status('completed', 'Автоматический переход с on-hold на completed после оплаты.');
}

4. Проверка конфликта с плагинами

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

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

После добавления кода и настройки платежного шлюза:

• Создайте тестовый заказ и оплатите его через выбранный метод.
• Перейдите в админку WooCommerce → Заказы и проверьте, изменился ли статус автоматически.
• Если статус не меняется, проверьте логи ошибок сервера и WooCommerce.
• Для отладки используйте плагин Clearfy Pro с функцией логирования и очистки кэша.

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

• Статус не меняется, хотя код добавлен: Возможно, платежный шлюз не вызывает хук woocommerce_payment_complete. Проверьте, поддерживает ли шлюз этот хук или используйте другие хуки, например woocommerce_order_status_changed.
• Конфликты с темой или плагинами: Некоторые темы или плагины могут переопределять статус заказа. Отключите их для теста.
• Ошибка в коде PHP: Проверьте синтаксис и логи ошибок сервера. Ошибки PHP могут блокировать выполнение кода.
• Отсутствие прав записи: Если сайт на хостинге с ограничениями, убедитесь, что у скриптов есть необходимые права.

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

• Добавляйте кастомный код в дочернюю тему или отдельный плагин, чтобы не потерять изменения при обновлении.
• Убедитесь, что все хуки и фильтры работают только для нужных статусов и не вызываются лишний раз.
• Используйте логи WooCommerce для отслеживания успешных и неудачных попыток обновления статуса.
• Для сложных случаев с несколькими платежными шлюзами делайте индивидуальную обработку статусов.

Сравнение вариантов реализации автоматического изменения статуса заказа