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

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

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

Типичные симптомы:

• Заказы застревают в статусе "В ожидании оплаты", хотя способ оплаты изменён на "Оплачено".
• Заказы остаются в статусе "Обработка", хотя способ оплаты изменён на "Отложенный платеж".
• Ручное обновление статуса уходит в обход автоматизации, увеличивая нагрузку на менеджеров.

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

1. Использование хука woocommerce_update_order для отслеживания изменений

Хук woocommerce_update_order срабатывает при обновлении заказа. Можно получить старый и новый способ оплаты и сравнить их, чтобы определить изменение.

2. Реализация функции для автоматической смены статуса

add_action('woocommerce_update_order', 'auto_change_order_status_on_payment_method_change', 10, 1);

function auto_change_order_status_on_payment_method_change($order_id) {
    if (! $order_id) {
        return;
    }

    $order = wc_get_order($order_id);
    if (! $order) {
        return;
    }

    // Получаем текущий способ оплаты
    $new_payment_method = $order->get_payment_method();

    // Получаем старый способ оплаты из мета, если есть
    $old_payment_method = get_post_meta($order_id, '_old_payment_method', true);

    // Если способ оплаты не изменился - выходим
    if ($new_payment_method === $old_payment_method) {
        return;
    }

    // Сохраняем новый способ оплаты в мета для следующего сравнения
    update_post_meta($order_id, '_old_payment_method', $new_payment_method);

    // Логика смены статуса по способу оплаты
    switch ($new_payment_method) {
        case 'bacs': // Банковский перевод
            $order->update_status('on-hold', 'Автоматическое изменение статуса: ожидает подтверждения оплаты банковским переводом');
            break;
        case 'cheque': // Чек
            $order->update_status('on-hold', 'Ожидает подтверждения оплаты чеком');
            break;
        case 'cod': // Оплата при доставке
            $order->update_status('processing', 'Оплата при доставке, заказ в обработке');
            break;
        case 'paypal': // PayPal
        case 'stripe': // Stripe
            $order->update_status('processing', 'Оплата подтверждена через онлайн-платеж');
            break;
        default:
            // Для остальных способов оставляем статус без изменений
            break;
    }

    $order->save();
}

3. Инициализация мета-данных для существующих заказов

Для корректной работы скрипта добавьте инициализацию мета _old_payment_method для существующих заказов через WP-CLI или SQL-запрос.

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

• Измените способ оплаты в админке WooCommerce для существующего заказа и обновите его.
• Обратите внимание на изменение статуса заказа: он должен автоматически перейти в нужный статус согласно логике.
• Создайте новый заказ, измените способ оплаты и проверьте, что статус также меняется автоматически.
• Проверьте логи WooCommerce для сообщений об изменении статуса.

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

• Отсутствие инициализации _old_payment_method для старых заказов: скрипт не сработает при первом изменении, т.к. не с чем сравнивать. Решение — заполнить мета для всех существующих заказов.
• Хук woocommerce_update_order срабатывает слишком часто: убедитесь, что обновление статуса происходит только при изменении способа оплаты, чтобы избежать бесконечных циклов.
• Способ оплаты не совпадает с ключами (например, 'stripe' или 'paypal'): проверьте точное значение способа оплаты через get_payment_method() и используйте именно эти значения в switch.
• Статус заказа не меняется из-за ограничений плагинов безопасности или кэширования: временно отключите их для теста.

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

• Используйте проверку nonce и прав пользователя, если функцию вызываете из внешних запросов.
• Минимизируйте работу с базой — обновляйте мета только при реальном изменении.
• Для крупных магазинов используйте WP-CLI или cron-скрипты для массовой инициализации мета и тестирования.
• Тестируйте на staging-среде, чтобы исключить конфликты с плагинами оплаты.

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