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

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

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

Основные причины такой проблемы:

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

Как пошагово настроить автоматическое изменение статуса заказа

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

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

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

2. Добавление кода для автоматического изменения статуса

Если платеж прошёл успешно, но заказ остаётся в статусе "обработка", можно добавить пользовательский хук в файл 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) return;

    // Проверяем текущий статус, чтобы избежать лишних изменений
    if ($order->get_status() !== 'completed') {
        $order->update_status('completed', 'Статус изменён автоматически после успешного платежа.');
    }
}

Этот код сработает сразу после успешного завершения оплаты и переведёт заказ в статус "completed".

3. Альтернативный хук для платежей с отложенной обработкой

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

add_action('woocommerce_order_status_processing', 'custom_auto_complete_order', 20, 1);
function custom_auto_complete_order($order_id) {
    $order = wc_get_order($order_id);
    if ($order->has_status('processing')) {
        $order->update_status('completed', 'Автоматическое завершение заказа после обработки.');
    }
}

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

• Создайте тестовый заказ в магазине и пройдите процесс оплаты.
• После подтверждения оплаты проверьте в админке WooCommerce статус заказа — он должен измениться на "completed" (или другой заданный).
• Проверьте логи WooCommerce и веб-сервера на наличие ошибок.
• Можно добавить запись в лог в коде для отладки:

if (defined('WP_DEBUG') && WP_DEBUG) {
    error_log('Order ' . $order_id . ' status changed to completed');
}

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

• Код не срабатывает: Проверьте, что код добавлен в активную тему или плагин, и нет синтаксических ошибок.
• Конфликты с другими плагинами: Отключите плагины, которые могут управлять статусами заказов, и протестируйте повторно.
• Платёжный шлюз не отправляет уведомления: Проверьте настройки IPN/Webhook, доступность URL и правильность секретных ключей.
• Статус меняется, но потом откатывается: Возможно, другие хуки перекрывают изменение статуса. Используйте приоритет в add_action (например, 20).

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

• Не изменяйте статус заказа без проверки платежа — всегда убедитесь в подтверждении оплаты через надёжный источник (API платежного шлюза или вебхук).
• Используйте отдельный плагин или дочернюю тему для кастомного кода, чтобы избежать потери изменений при обновлениях.
• Добавляйте логирование для важных операций с заказами, чтобы быстро выявлять проблемы.
• Если используете сторонние плагины для управления статусами, проверьте их совместимость с вашим платежным шлюзом.

Сравнение способов изменения статуса заказа в WooCommerce

Метод	Преимущества	Недостатки
Хук woocommerce_payment_complete	Простой и надёжный для большинства платежей	Не работает с отложенными платежами
Хук woocommerce_order_status_processing	Подходит для асинхронных платежей	Может сработать слишком рано, если платеж не подтверждён
Обработка Webhook/API платежного шлюза	Высокая точность и контроль	Сложнее в реализации, требует настройки сервера