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

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

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

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

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

Пошаговое решение: корректное изменение статуса заказа после успешного платежа

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

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

add_action('woocommerce_payment_complete', 'custom_change_order_status_after_payment', 10, 1);
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() !== 'processing') {
        // Меняем статус на 'processing' (Обработка)
        $order->update_status('processing', 'Статус заказа изменен автоматически после оплаты.');
    }
}

2. Учет особенностей платежных шлюзов

Некоторые шлюзы (например, PayPal, Stripe) могут использовать собственные хуки или статусные уведомления. Для PayPal IPN можно использовать хук woocommerce_paypal_ipn_process_request, а для Stripe — woocommerce_stripe_payment_complete. Но чаще всего woocommerce_payment_complete универсален.

3. Дополнительная проверка оплаты

Иногда полезно проверить, что платеж действительно успешен, особенно если платежный шлюз не отдаёт полный статус:

add_action('woocommerce_payment_complete', 'custom_check_and_update_order_status', 10, 1);
function custom_check_and_update_order_status($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) {
        return;
    }

    // Проверка, что заказ оплачен
    if ($order->is_paid()) {
        $order->update_status('processing', 'Статус автоматически обновлен после подтверждения оплаты.');
    }
}

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

• Оформите тестовый заказ и проведите оплату через выбранный платежный шлюз.
• После успешной оплаты статус заказа должен автоматически измениться на «обработка» или указанный вами.
• Проверьте в админке WooCommerce — статус заказа и комментарии к заказу должны содержать сообщение об автоматическом изменении.
• Можно дополнительно включить режим отладки WooCommerce и просмотреть логи для подтверждения срабатывания хука.

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

• Статус заказа не меняется: Возможно, не сработал хук из-за несовместимости с платежным плагином. Проверьте, вызывается ли do_action('woocommerce_payment_complete', $order_id) в коде плагина.
• Дублирование смены статуса: Если в коде несколько обработчиков на один и тот же хук — возможны конфликты. Используйте приоритеты и проверки текущего статуса.
• Плагин кэширования блокирует обновление: Очистите кэш и отключите кэширование для страниц заказа.
• Ошибки в логах PHP: Проверьте, нет ли ошибок в кастомных функциях, особенно при вызове wc_get_order().

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

• Используйте минимально необходимые хуки и не меняйте статус заказов без веской причины.
• Не храните лишние данные в комментариях к заказам — это замедляет обработку.
• Логируйте только ошибки, чтобы не засорять логи сервера.
• Тестируйте изменения на дев-среде, чтобы избежать сбоев в рабочем магазине.
• Если используете сторонние плагины для платежей — изучайте их документацию по хукам.

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