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

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

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

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

1. Выбираем правильный хук для отлова успешной оплаты

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

2. Добавляем пользовательскую логику отмены заказа

В функции-обработчике можно проверить условия отмены (например, по мета-данным, комментариям или внешним признакам) и при необходимости сменить статус заказа на cancelled.

add_action('woocommerce_payment_complete', 'wp_cancel_order_after_payment', 20, 1);
function wp_cancel_order_after_payment($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    
    // Пример условия отмены: если заказ содержит товар с ID 123
    foreach ($order->get_items() as $item) {
        if ($item->get_product_id() == 123) {
            $order->update_status('cancelled', __('Заказ отменен автоматически: товар недоступен', 'woocommerce'));
            
            // Можно добавить уведомление администратору
            wp_mail(get_option('admin_email'), 'Заказ отменен', 'Заказ #' . $order_id . ' отменен после оплаты.');
            break;
        }
    }
}

3. Размещение кода

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

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

• Создайте тестовый заказ с товаром, подходящим под условие отмены (ID 123).
• Оплатите заказ через тестовый режим платежной системы.
• После успешной оплаты проверьте, что статус заказа изменился на "Отменён" в админ-панели WooCommerce.
• Убедитесь, что клиент получил уведомление (если настроено) и администратор — сообщение на почту.

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

• Хук срабатывает, но статус не меняется: проверьте, что используете метод update_status() правильно и что у заказа действительно есть нужные товары.
• Отмена происходит для всех заказов: уточните условие внутри цикла, чтобы отменять только при нужных критериях.
• Конфликты с другими плагинами: попробуйте изменить приоритет хука (например, 20 или выше) или отключить другие плагины для теста.
• Отмена заказа не уведомляет клиента: настройте дополнительную отправку письма через wc_add_notice() или используйте стандартные e-mail WooCommerce.

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

• Всегда тестируйте на локальной или staging-среде, чтобы не нарушить работу магазина в продакшене.
• Добавляйте логирование действий, например, через error_log() или собственные файлы, чтобы отследить выполнение функции.
• Не выполняйте тяжелые операции внутри хука — если нужно, используйте wp_schedule_single_event() для отложенной обработки.
• Проверяйте права доступа и корректность данных, чтобы исключить случайные или злонамеренные отмены.

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