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

Проблема с неуспешными заказами в WooCommerce

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

Диагностика проблемы: как понять, что заказ нужно отменить

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

• Заказ остаётся в статусе pending или on-hold дольше установленного времени.
• Нет подтверждения оплаты (нет статуса processing или completed).
• Платёжный шлюз не отправил успешного уведомления.

Важно проверить, что у вас не настроены автоматические отложенные оплаты (например, банковские переводы), которые требуют ручного подтверждения.

Решение: автоматическая отмена заказов через крон-задачу

Для автоматической отмены неуспешных заказов используем WP-Cron, который будет запускать проверку и обновлять статус заказов, если они не были оплачены в течение заданного времени.

Шаг 1. Добавляем функцию отмены заказов

function wpbono_cancel_unpaid_orders() {
    $cutoff = strtotime('-1 hour'); // Время ожидания оплаты - 1 час

    $args = array(
        'status' => array('pending', 'on-hold'),
        'date_created' => '<' . date('Y-m-d H:i:s', $cutoff),
        'limit' => -1,
    );

    $orders = wc_get_orders($args);

    foreach ($orders as $order) {
        $order->update_status('cancelled', 'Автоматическая отмена заказа из-за отсутствия оплаты.');
    }
}

Шаг 2. Регистрируем крон-задачу

function wpbono_schedule_cancel_unpaid_orders() {
    if (!wp_next_scheduled('wpbono_cancel_unpaid_orders_hook')) {
        wp_schedule_event(time(), 'hourly', 'wpbono_cancel_unpaid_orders_hook');
    }
}
add_action('wp', 'wpbono_schedule_cancel_unpaid_orders');
add_action('wpbono_cancel_unpaid_orders_hook', 'wpbono_cancel_unpaid_orders');

Шаг 3. Очистка при деактивации плагина или темы

function wpbono_clear_scheduled_cancel_unpaid_orders() {
    $timestamp = wp_next_scheduled('wpbono_cancel_unpaid_orders_hook');
    if ($timestamp) {
        wp_unschedule_event($timestamp, 'wpbono_cancel_unpaid_orders_hook');
    }
}
register_deactivation_hook(__FILE__, 'wpbono_clear_scheduled_cancel_unpaid_orders');

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

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

• Создайте тестовый заказ с любым способом оплаты, который не будет оплачен.
• Установите время ожидания в функции wpbono_cancel_unpaid_orders на несколько минут (например, strtotime('-5 minutes')).
• Запустите крон вручную, вызвав функцию wpbono_cancel_unpaid_orders() через консоль WP-CLI или временно добавьте вызов в шаблон.
• Проверьте, изменился ли статус заказа на cancelled.

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

• Отмена заказов, которые ещё могут быть оплачены: слишком короткое время ожидания. Решение — увеличить интервал до 30 минут или 1 часа.
• Крон-задача не запускается: убедитесь, что на сайте есть трафик (WP-Cron запускается при заходе посетителей) или настройте системный cron для wp-cron.php.
• Заказы с другими статусами отменяются: проверьте фильтр по статусам заказов в запросе.
• Проблемы с множественными статусами заказа одновременно: используйте правильный формат массива для параметра 'status' в wc_get_orders.

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

• Не устанавливайте слишком короткий интервал отмены — это может привести к отмене заказов, которые находятся в процессе оплаты.
• Используйте WP-CLI для ручного запуска задачи при тестировании, чтобы не ждать крон-события.
• Если у вас большой магазин, ограничьте количество обрабатываемых заказов за раз (параметр 'limit' в wc_get_orders), чтобы не перегружать сервер.
• Логируйте действия отмены заказов в отдельный файл или системный лог для отладки и аудита.

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