WooCommerce: автоматическое изменение статуса заказа при неудачной оплате

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

В WooCommerce часто возникает ситуация, когда заказ остается в статусе processing или on-hold, несмотря на то, что пользователь не завершил оплату или платеж был отклонен. Это приводит к путанице в учете и мешает автоматизации обработки заказов.

Основные симптомы:

• Заказы с неоплаченным статусом не меняют статус автоматически
• Администратору приходится вручную отслеживать неоплаченные заказы
• Отсутствуют уведомления или действия по удалению таких заказов

Как WooCommerce обрабатывает статусы оплаты

WooCommerce использует статусы заказов для управления жизненным циклом покупки. Статусы pending и on-hold обычно означают, что оплата еще не прошла, а processing — что оплата получена и заказ готовится к выполнению. Если платеж не прошел, статус должен оставаться в ожидании или измениться на failed.

Почему автоматическое изменение статуса не работает

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

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

Для реализации автоматического изменения статуса используем хук woocommerce_order_status_pending_to_failed или собственный cron-скрипт, который проверяет заказы со статусом pending или on-hold и меняет статус, если оплата не прошла в течение заданного времени.

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

add_action('wp', 'wpd_schedule_check_unpaid_orders');
function wpd_schedule_check_unpaid_orders() {
    if (!wp_next_scheduled('wpd_check_unpaid_orders_hook')) {
        wp_schedule_event(time(), 'hourly', 'wpd_check_unpaid_orders_hook');
    }
}

add_action('wpd_check_unpaid_orders_hook', 'wpd_check_unpaid_orders');
function wpd_check_unpaid_orders() {
    $args = [
        'limit' => -1,
        'status' => ['pending', 'on-hold'],
        'date_created' => '<' . (new WC_DateTime('-1 hour'))->format('Y-m-d H:i:s'),
    ];
    $orders = wc_get_orders($args);
    foreach ($orders as $order) {
        // Проверяем, есть ли оплата
        if (!$order->is_paid()) {
            $order->update_status('failed', 'Автоматическое изменение статуса из-за отсутствия оплаты');
        }
    }
}

2. Ручной запуск для тестирования

Для проверки работоспособности функции временно вызовите wpd_check_unpaid_orders() в файле functions.php или через WP CLI:

wp eval 'wpd_check_unpaid_orders();'

Проверка результата

• Создайте заказ со статусом pending и не оплачивайте его
• Подождите более часа или выполните ручной запуск функции
• Проверьте, что статус заказа изменился на failed
• В панели WooCommerce в комментариях к заказу появится запись об изменении статуса

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

• Крон-задача не запускается: Проверьте, что WordPress cron включен и работает. Для отладки используйте плагин WP Crontrol.
• Некорректный выбор заказов: Убедитесь, что в аргументах wc_get_orders() правильно указаны статусы и дата создания.
• Статус не меняется из-за конфликтов: Отключите временно сторонние плагины, которые могут влиять на статусы заказов.

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

• Не увеличивайте частоту cron-задачи чаще одного раза в час, чтобы избежать нагрузки на базу данных.
• При большом количестве заказов используйте постраничный вывод (paginate) в wc_get_orders(), чтобы не перегружать память.
• Логируйте изменения статусов в отдельный файл для аудита и отладки.
• Если используете сторонние платежные шлюзы, убедитесь, что webhook'и корректно настроены и обновляют статус заказа.

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