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

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

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

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

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

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

1. Проверка текущего статуса и способа оплаты

Для начала нужно убедиться, что заказ успешно оплачен, и определить, какой метод оплаты использовался. Для этого можно подключить хук woocommerce_payment_complete — он срабатывает при подтверждении оплаты.

2. Добавление кода в functions.php или кастомный плагин

Ниже пример кода, который автоматически меняет статус заказа на "processing" после успешной оплаты для всех платежных методов:

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

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

3. Специфическая обработка для конкретных платежных шлюзов

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

add_action('woocommerce_order_status_pending_to_processing', 'custom_payment_gateway_order_status_change', 10, 1);
function custom_payment_gateway_order_status_change($order) {
    if ($order->get_payment_method() === 'your_gateway_id') {
        $order->update_status('completed', 'Оплата подтверждена через ваш шлюз');
    }
}

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

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

1. Создайте тестовый заказ на сайте с оплатой через нужный шлюз.
2. Произведите оплату в тестовом режиме платежной системы.
3. Перейдите в админку WooCommerce → Заказы и проверьте, изменился ли статус заказа с pending на processing или completed.
4. Также можно добавить логирование в функцию, чтобы видеть срабатывает ли хук:

error_log('Статус заказа #'. $order_id .' изменен автоматически');

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

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

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

• Добавляйте проверки на существование объекта заказа перед операциями с ним, чтобы избежать фатальных ошибок.
• Не меняйте статусы заказов без проверки — это может привести к некорректной отчетности и проблемам с клиентами.
• Используйте логирование через error_log или специализированные плагины для отладки и мониторинга webhook.
• Если магазин большой, избегайте тяжелых операций в хуках оплаты, чтобы не замедлять процесс оформления заказа.

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