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

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

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

Чтобы диагностировать проблему, сначала проверьте, какие статусы заказов устанавливаются при различных событиях оплаты. Для этого можно вывести текущий статус и историю изменений заказов, например, с помощью административной панели или SQL-запроса:

SELECT post_status, post_date FROM wp_posts WHERE post_type = 'shop_order' ORDER BY post_date DESC LIMIT 10;

Также важно проверить логи платежных шлюзов и WooCommerce (если включена отладка в wp-config.php):

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Логи находятся в wp-content/debug.log. Они помогут понять, почему статус не меняется автоматически.

Пошаговое решение: автоматическое изменение статуса заказа на "Отменён" при неудачной оплате

1. Подключение нужного хука WooCommerce

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

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

add_action('woocommerce_order_status_pending_to_failed', 'auto_cancel_order_on_failed_payment', 10, 1);
function auto_cancel_order_on_failed_payment($order) {
    if (!$order instanceof WC_Order) { return; }

    // Проверяем текущий статус
    if ($order->get_status() === 'failed') {
        // Меняем статус на 'cancelled'
        $order->update_status('cancelled', 'Заказ отменён автоматически из-за неудачной оплаты.');
    }
}

3. Альтернативный хук для других статусов

Если у вас платежный шлюз выставляет другие статусы (например, "on-hold" или "processing"), можно добавить дополнительные хуки:

add_action('woocommerce_order_status_on-hold_to_failed', 'auto_cancel_order_on_failed_payment');
add_action('woocommerce_order_status_processing_to_failed', 'auto_cancel_order_on_failed_payment');

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

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

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

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

1. Хук не срабатывает

• Причина: платежный шлюз не меняет статус заказа на failed, а использует другой статус (например, on-hold).
• Решение: добавьте дополнительные хуки, отслеживающие другие статусы, или используйте более универсальный хук woocommerce_order_status_changed с дополнительной проверкой.

2. Некорректное определение объекта заказа

• Причина: функция получает ID заказа, а не объект WC_Order.
• Решение: убедитесь, что в функции параметр — объект заказа, либо преобразуйте ID в объект:

function example_callback($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;
    // дальше работа с $order
}

3. Конфликт с другими плагинами управления статусами

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

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

• Добавляйте свой код в дочернюю тему или собственный плагин, чтобы избежать потери изменений при обновлениях.
• Используйте кеширование и минимизируйте запросы к БД — в данном случае обработка события не требует дополнительных запросов.
• Логируйте критичные события в отдельный файл для упрощения отладки и мониторинга.
• Тестируйте на staging-сайте перед внедрением в продакшн.

Сравнение вариантов автоматического изменения статусов заказов

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