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

В чём заключается проблема с отменой оплаченных заказов в WooCommerce

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

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

• Заказ со статусом processing или completed отменён, но статус остался прежним.
• В админке не отражается переход в статус cancelled или другой ожидаемый.
• Нет логов или уведомлений о смене статуса.
• Проверка через хук woocommerce_order_status_changed не фиксирует событие отмены.

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

Для автоматизации нужно добавить пользовательский код, который отслеживает попытку отмены заказа и меняет статус в зависимости от условий (например, если заказ оплачен — переводит в статус cancelled или кастомный).

Добавьте следующий код в файл functions.php вашей дочерней темы или в плагин с пользовательскими функциями:

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

    // Проверяем, что заказ оплачен
    if ($order->is_paid()) {
        // Можно изменить статус на кастомный или выполнить дополнительные действия
        // Пример: логирование
        error_log('Заказ #'. $order_id .' отменён после оплаты.');

        // Если нужен другой статус, например refunded, можно использовать:
        // $order->update_status('refunded', 'Автоматический возврат после отмены оплаченного заказа');
    }
}

Если требуется изменить статус именно при вызове отмены (например, при вызове отмены через админку или API), можно использовать хук woocommerce_order_status_changed и проверять переход:

add_action('woocommerce_order_status_changed', 'wpdirect_auto_change_status_on_cancel', 10, 4);
function wpdirect_auto_change_status_on_cancel($order_id, $old_status, $new_status, $order) {
    if ($new_status !== 'cancelled') return;

    if ($order->is_paid()) {
        // Пример смены статуса с cancelled на refunded
        $order->update_status('refunded', 'Автоматическое изменение статуса на refunded после отмены оплаченного заказа');
    }
}

Советы по кастомизации

• Статус refunded — стандартный WooCommerce статус, подходящий для возвратов.
• Можно создать собственный статус заказа, если стандартные не подходят, с помощью register_post_status и интеграции в WooCommerce.
• Добавляйте уведомления клиенту через email при смене статуса, используя стандартные email-шаблоны WooCommerce.

Как проверить, что автоматическое изменение статуса работает

1. Создайте тестовый заказ и оплатите его через любой шлюз.
2. В админке отмените заказ вручную.
3. Проверьте, что статус автоматически меняется с cancelled на refunded или заданный вами.
4. Посмотрите логи сервера (например, error_log) на наличие сообщений, если добавляли логирование.
5. Проверьте почту клиента, если настроены уведомления о смене статуса.

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

• Код не работает после добавления в functions.php: Проверьте, активна ли дочерняя тема, и нет ли синтаксических ошибок в файле. Рекомендуется включить WP_DEBUG и смотреть ошибки.
• Статус не меняется на нужный: Возможно, статус не зарегистрирован в WooCommerce. Проверьте список статусов через wc_get_order_statuses() и используйте только существующие или зарегистрируйте свой.
• Обновление статуса вызывает бесконечный цикл: При использовании хука woocommerce_order_status_changed будьте осторожны с повторным вызовом update_status. Добавьте проверку, чтобы избежать рекурсии.
• Не срабатывает для всех платежных шлюзов: Некоторые шлюзы могут использовать нестандартные статусы. Проверьте, что метод is_paid() возвращает корректно для вашего шлюза.

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

• Добавляйте проверку nonce и capability, если вызываете смену статусов через AJAX или формы.
• Избегайте тяжелых операций внутри хуков смены статуса — лучше вынесите их в отложенные задачи (WP-Cron).
• Логирование ошибок и действий — полезно, но не забывайте очищать логи и не писать в них чувствительные данные.
• Для больших магазинов с сотнями заказов в день автоматизация статусов снижает нагрузку на персонал и минимизирует ошибки учёта.

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