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

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

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

Чтобы убедиться, что у вас именно такая ситуация, проверьте заказы с неуспешной оплатой в админке (WooCommerce → Заказы). Если они долго не меняют статус, значит автоматизация нужна.

Обзор стандартного поведения WooCommerce и необходимость кастомизации

WooCommerce не предоставляет встроенного механизма автоматической отмены заказов после неудачной оплаты. Однако можно реализовать это с помощью кастомного кода, который будет проверять статус заказов и менять их на «Отменён» через заданный промежуток времени.

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

Удаление заказов не рекомендуется, так как это нарушит историю продаж и отчётность, а также может вызвать проблемы с восстановлением данных. Статус «Отменён» – стандартный и безопасный способ пометить такие заказы.

Пошаговое решение: автоматическая отмена заказов через WP-Cron

Для автоматической отмены создадим функцию, которая будет запускаться по расписанию и менять статус заказов с «Ожидает оплаты» (pending) на «Отменён» (cancelled) спустя установленное время (например, 1 час).

1. Добавляем периодический крон-задачу

add_filter('cron_schedules', function($schedules) {
    if (!isset($schedules['every_fifteen_minutes'])) {
        $schedules['every_fifteen_minutes'] = [
            'interval' => 900, // 15 минут в секундах
            'display' => __('Каждые 15 минут')
        ];
    }
    return $schedules;
});

2. Регистрируем событие при активации темы или плагина

function wpbono_schedule_order_cancellation() {
    if (!wp_next_scheduled('wpbono_cancel_unpaid_orders')) {
        wp_schedule_event(time(), 'every_fifteen_minutes', 'wpbono_cancel_unpaid_orders');
    }
}
add_action('wp', 'wpbono_schedule_order_cancellation');

3. Функция обработки отмены заказов

add_action('wpbono_cancel_unpaid_orders', function() {
    $cutoff = strtotime('-1 hour'); // заказы старше 1 часа
    $args = [
        'limit' => -1,
        'status' => 'pending',
        'date_created' => '<' . date('Y-m-d H:i:s', $cutoff),
    ];
    $orders = wc_get_orders($args);
    foreach ($orders as $order) {
        $order->update_status('cancelled', 'Автоматическая отмена заказа из-за неудачной оплаты');
    }
});

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

Создайте тестовый заказ и не оплачивайте его. Подождите более часа (или измените время в коде на 5 минут для теста), затем проверьте статус заказа в админке. Он должен смениться на «Отменён» автоматически.

Также можно проверить логи сервера на предмет ошибок при срабатывании WP-Cron или добавить временно error_log внутри функции для отладки.

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

• WP-Cron не запускается: Если сайт не получает трафик, задачи WP-Cron могут не выполняться. Решение: настроить системный cron на сервере для вызова wp-cron.php или использовать плагин WP Crontrol для диагностики.
• Заказы не находят по дате создания: В WooCommerce 4.4+ параметр date_created должен передаваться как массив с ключами before и after. Пример: 'date_created' => ['before' => date('Y-m-d H:i:s', $cutoff)]. В противном случае заказы могут не фильтроваться корректно.
• Статус не меняется из-за кеша: Иногда кеширование на стороне сервера или плагина мешает обновлению статусов. Очистите кеш и проверьте повторно.

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

• Ограничьте выборку заказов в функции отмены, чтобы избежать больших нагрузок. Например, добавьте 'limit' => 20.
• Используйте транзиенты или флаги для отметки уже обработанных заказов, если база очень большая.
• Если вы используете плагин Clearfy Pro, проверьте, что он не блокирует WP-Cron задачи.
• Проверяйте права доступа: убедитесь, что функция не меняет статусы заказов без проверки ролей, если вызывается вручную.

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