WooCommerce: как автоматически отключать заказы при отмене платежа

Диагностика проблемы с отменой платежей в WooCommerce

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

Проверить наличие проблемы просто: после отмены (refund) или отклонения платежа зайдите в админку WooCommerce → Заказы и посмотрите статус соответствующих заказов. Если статус не меняется автоматически на "отменен" или "отклонен", значит автоматизация отсутствует.

Почему WooCommerce не меняет статус заказа при отмене платежа

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

Пошаговое решение: автоматическое отключение заказов при отмене платежа

Реализуем обработчик, который будет слушать события отмены или возврата платежа и автоматически менять статус заказа на "отменен".

add_action('woocommerce_order_status_refunded', 'custom_cancel_order_on_refund', 10, 1);function custom_cancel_order_on_refund($order_id) {    if (!$order_id) return;    $order = wc_get_order($order_id);    if (!$order) return;    // Проверяем, что заказ еще не отменен    if ($order->get_status() !== 'cancelled') {        $order->update_status('cancelled', 'Заказ автоматически отменен из-за возврата платежа');    }}

Этот код реагирует на смену статуса заказа на "refunded" (возврат) и меняет статус на "cancelled". Можно добавить аналогичную логику для других событий платежного шлюза, если требуется.

Автоматическое отключение заказов при отклонении платежа (failed)

add_action('woocommerce_order_status_failed', 'custom_cancel_order_on_failed_payment', 10, 1);function custom_cancel_order_on_failed_payment($order_id) {    if (!$order_id) return;    $order = wc_get_order($order_id);    if (!$order) return;    if ($order->get_status() !== 'cancelled') {        $order->update_status('cancelled', 'Заказ автоматически отменен из-за неудачного платежа');    }}

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

1. Создайте тестовый заказ с оплатой через платежный шлюз, поддерживающий возвраты или отмены платежей.
2. Выполните возврат платежа в платежной системе или сгенерируйте статус "failed" для заказа.
3. Обновите страницу заказов в админке WooCommerce и убедитесь, что статус изменился на "отменен" автоматически.
4. Проверьте в истории изменения статуса заказа наличие комментария с причиной автоматической отмены.

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

• Код не срабатывает при возврате платежа: проверьте, что платежный шлюз действительно меняет статус заказа на "refunded". Если нет, нужно искать подходящий хук у конкретного шлюза.
• Статус заказа не меняется на "cancelled": убедитесь, что функция добавлена в файл functions.php темы или в плагин, и что ошибок PHP нет. Включите WP_DEBUG для отладки.
• Конфликты с другими плагинами: временно отключите другие плагины, чтобы проверить, не блокируют ли они смену статуса.

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

• Добавляйте проверки в код, чтобы не менять статус заказа без необходимости, это уменьшает нагрузку на базу данных.
• Логируйте изменения статуса заказов для аудита — можно использовать встроенный WooCommerce логгер:

if (class_exists('WC_Logger')) {    $logger = wc_get_logger();    $logger->info('Заказ ' . $order_id . ' отменен автоматически.', array('source' => 'auto-cancel'));}

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

Сравнение подходов к автоматическому отключению заказов