Как отменить заказ в WooCommerce после оплаты с помощью хуков

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

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

Пошаговое решение: отмена заказа через хуки WooCommerce

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

Статус completed означает, что оплата прошла и заказ завершён. Чтобы отменить заказ после оплаты, нужно отследить изменение статуса и внутри обработчика изменить статус обратно на cancelled по условию.

add_action('woocommerce_order_status_completed', 'wp_cancel_order_after_payment', 10, 1);
function wp_cancel_order_after_payment($order_id) {
    $order = wc_get_order($order_id);
    // Условие отмены - пример: если в заказе есть определённый товар
    foreach ($order->get_items() as $item) {
        if ($item->get_product_id() == 123) { // ID товара для отмены
            // Отмена заказа
            $order->update_status('cancelled', 'Заказ отменён автоматически после оплаты по условию.');
            break;
        }
    }
}

2. Отмена заказа вручную с помощью REST API или WP-CLI

Для массовой отмены заказов после оплаты можно использовать WP-CLI или REST API. Пример WP-CLI команды:

wp post list --post_type=shop_order --post_status=wc-completed --format=ids | xargs -n1 -I % wp post update % --post_status=wc-cancelled

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

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

• Создайте тестовый заказ с товаром, который попадает под условие отмены;
• Оплатите заказ (можно использовать платежный шлюз в тестовом режиме);
• Проверьте, что статус заказа автоматически изменился на cancelled;
• Убедитесь, что товары вернулись на склад (если включён учёт остатков);
• Проверьте логи WooCommerce для сообщений об отмене.

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

Ошибка 1: Статус заказа не меняется после оплаты

Причина: неправильно выбран хук или он не срабатывает из-за кэширования.

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

Ошибка 2: Отмена заказа ломает учёт остатков

Причина: статус cancelled по умолчанию не всегда запускает корректное восстановление остатков.

Решение: вручную вызвать функцию возврата остатков, например:

$order->reduce_order_stock(false); // отключаем снижение
$order->increase_order_stock(); // возвращаем остатки

Ошибка 3: Клиенты получают уведомления об отмене без объяснения причин

Причина: отсутствие кастомных уведомлений или неверный статус письма.

Решение: расширьте стандартные email-уведомления WooCommerce, добавьте пояснения в комментарии к заказу.

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

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

Сравнение способов отмены заказа после оплаты