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

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

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

Типичные ситуации, когда это мешает:

• Заказ получил статус "Оплачен" (processing или completed), но кто-то сменил его обратно на "В ожидании" или "Отклонён".
• Автоматизация внешней системы ожидает, что оплаченный заказ больше не изменится, а ручное вмешательство ломает логику.

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

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

1. Добавляем проверку и отмену изменения статуса в хук woocommerce_update_order

Для запрета изменения статуса после оплаты используем хук woocommerce_update_order, который срабатывает при обновлении заказа. Нам нужно получить текущий статус, проверить, был ли он уже оплачен, и если да — отменить изменение.

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

add_action('woocommerce_update_order', 'block_status_change_after_payment', 10, 1);
function block_status_change_after_payment($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Статусы, которые считаются оплачены
    $paid_statuses = array('processing', 'completed');

    // Получаем старый статус из мета
    $old_status = get_post_meta($order_id, '_old_order_status', true);
    $new_status = $order->get_status();

    // Если старого статуса нет, записываем текущий для будущих сравнений
    if (!$old_status) {
        update_post_meta($order_id, '_old_order_status', $new_status);
        return;
    }

    // Если заказ уже был оплачен, и статус пытаются изменить - откатываем
    if (in_array($old_status, $paid_statuses) && $new_status !== $old_status) {
        // Откатываем статус
        $order->set_status($old_status);
        $order->save();
        // Можно добавить уведомление в админку
        wc_add_notice(__('Изменение статуса оплаченного заказа запрещено.'), 'error');
    } else {
        // Обновляем старый статус
        update_post_meta($order_id, '_old_order_status', $new_status);
    }
}

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

• Создайте тестовый заказ и измените его статус на "processing" или "completed" — статус сохранится и запишется в метаданные.
• Попробуйте вручную изменить статус на другой (например, "on-hold" или "cancelled"). Статус должен автоматически вернуться к "processing" или "completed".
• Проверьте, что в админке появляется сообщение об ошибке (wc_add_notice будет работать в интерфейсе, если обновление происходит из админки).

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

• Статус не откатывается после изменения. Проверьте, что код подключен и нет конфликтов с другими плагинами, которые также работают со статусами заказов. Для отладки добавьте error_log() внутри функции.
• Сообщение об ошибке не появляется в админке. В некоторых случаях wc_add_notice не выводит уведомления в админке. Можно использовать admin_notices для кастомных сообщений.
• Старый статус не записывается. Убедитесь, что функция вызывается после того, как заказ был создан, и что мета корректно сохраняется.

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

• Используйте конкретные статусы для проверки — не все статусы WooCommerce означают оплату.
• Минимизируйте количество вызовов update_post_meta, чтобы не нагружать БД.
• Для мультиадминистраторских сайтов добавьте логику, позволяющую определённым ролям (например, супер-админам) менять статус без ограничений.
• Документируйте и комментируйте код, чтобы другие разработчики понимали намерения.

Сравнение вариантов реализации