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

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

Часто в WooCommerce возникают ситуации, когда после успешной оплаты заказа статус не меняется автоматически на нужный (например, с "В ожидании" на "Обработан" или "Завершён"). Это приводит к путанице в учёте заказов и задержкам в обработке. Причины могут быть связаны с особенностями платёжного шлюза, конфликтами плагинов или некорректной логикой обработки статусов в теме.

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

• Логирование событий оплаты (например, в WooCommerce > Статус > Журнал ошибок)
• Проверка настроек платёжного шлюза (особенно callback URL и webhook)
• Отключение сторонних плагинов, влияющих на заказы
• Анализ хуков оплаты и изменения статуса через add_action и add_filter

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

1. Использование стандартных хуков WooCommerce

WooCommerce предоставляет хук woocommerce_payment_complete, который срабатывает при успешной оплате заказа. Используем его для смены статуса:

add_action('woocommerce_payment_complete', '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) return;

    // Проверяем текущий статус и меняем при необходимости
    if ($order->get_status() === 'on-hold' || $order->get_status() === 'pending') {
        $order->update_status('processing', 'Статус изменён автоматически после оплаты');
    }
}

2. Обработка webhook от платёжного шлюза

Если платёжный шлюз использует webhook, убедитесь, что он корректно настроен и вызывает изменение статуса. Пример обработки webhook для PayPal (сокращённый):

add_action('woocommerce_api_paypal_webhook', 'handle_paypal_webhook');
function handle_paypal_webhook() {
    $payload = @file_get_contents('php://input');
    $data = json_decode($payload, true);

    if (!empty($data['resource']['invoice_id'])) {
        $order_id = intval($data['resource']['invoice_id']);
        $order = wc_get_order($order_id);

        if ($order && $data['event_type'] === 'PAYMENT.SALE.COMPLETED') {
            $order->update_status('processing', 'Оплата подтверждена PayPal');
        }
    }
    status_header(200);
    exit;
}

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

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

1. Создайте тестовый заказ в WooCommerce с нужным платёжным методом.
2. Совершите оплату (можно в тестовом режиме платёжного шлюза).
3. Перейдите в админку WooCommerce → Заказы и убедитесь, что статус заказа изменился автоматически на "Обрабатывается" или другой нужный.
4. Проверьте журнал событий WooCommerce на наличие ваших сообщений об обновлении статуса.

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

• Статус не меняется после оплаты: проверьте, срабатывает ли хук woocommerce_payment_complete или webhook платёжного шлюза.
• Проблемы с webhook: убедитесь, что URL webhook прописан правильно и сервер принимает POST-запросы.
• Конфликт плагинов: временно отключите все плагины, кроме WooCommerce, и проверьте логику.
• Неподдерживаемые статусы: используйте только статусы, зарегистрированные в WooCommerce (pending, on-hold, processing, completed и т.п.).

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

• Обрабатывайте webhook только после валидации подписи или токена от платёжного сервиса, чтобы избежать подделки запросов.
• Не используйте тяжелые операции в хуках оплаты — лучше ставьте задачи на очередь (например, через Action Scheduler).
• Логи ошибок и событий храните с ротацией, чтобы не засорять файловую систему.
• Проверяйте права доступа к обработчикам webhook, чтобы исключить внешние атаки.

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