WooCommerce: как автоматически обрабатывать возвраты и отмены заказов

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

Магазины на WooCommerce часто сталкиваются с необходимостью быстро обрабатывать возвраты и отмены заказов, чтобы не допустить ошибок учета и не портить клиентский опыт. Ручное управление такими процессами при большом объеме заказов становится непрактичным и подвержено ошибкам.

Основные признаки проблемы:

• Ручная отмена заказов занимает много времени;
• При отмене не происходит возврат средств или статус заказа остается некорректным;
• Отсутствует единая логика автоматической обработки возвратов по истечении срока;
• Дублирование заказов или ошибки в базе данных после отмены.

Пошаговое решение: Автоматизация обработки возвратов и отмен заказов с помощью кода

1. Определяем критерии автоматической отмены и возврата

Например, отменять заказы со статусом pending или on-hold, которые не были оплачены в течение 7 дней, и переводить их в статус cancelled.

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

В functions.php или в собственном плагине регистрируем задачу, которая раз в сутки проверяет заказы и отменяет просроченные:

if ( ! wp_next_scheduled( 'auto_cancel_unpaid_orders' ) ) {
    wp_schedule_event( time(), 'daily', 'auto_cancel_unpaid_orders' );
}

add_action( 'auto_cancel_unpaid_orders', 'auto_cancel_unpaid_orders_callback' );

function auto_cancel_unpaid_orders_callback() {
    $args = [
        'limit' => -1,
        'status' => ['pending', 'on-hold'],
        'date_created' => '<' . ( time() - WEEK_IN_SECONDS ),
    ];

    $orders = wc_get_orders( $args );

    foreach ( $orders as $order ) {
        $order->update_status( 'cancelled', 'Автоматическая отмена неоплаченного заказа через 7 дней.' );
        // При необходимости можно добавить логику возврата средств здесь
    }
}

3. Автоматический возврат средств для оплаченных заказов

Если требуется автоматизировать возврат средств (refund), то для заказов со статусом processing или completed можно добавить функцию:

function auto_refund_order( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( ! $order ) return;

    if ( in_array( $order->get_status(), ['processing', 'completed'] ) ) {
        // Проверяем, что возврат еще не был выполнен
        if ( ! $order->has_status('refunded') ) {
            $refund = wc_create_refund( [
                'amount' => $order->get_total(),
                'reason' => 'Автоматический возврат',
                'order_id' => $order_id,
            ] );

            if ( is_wp_error( $refund ) ) {
                error_log('Ошибка возврата для заказа ' . $order_id . ': ' . $refund->get_error_message());
            } else {
                $order->update_status( 'refunded', 'Автоматический возврат средств.' );
            }
        }
    }
}

Вызывайте эту функцию в нужный момент, например, по крону или вручную при необходимости.

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

Чтобы проверить, что автоматизация работает:

• Создайте тестовый заказ со статусом pending и датой создания более 7 дней назад. Запустите крон-задачу вручную или дождитесь ее выполнения. Заказ должен автоматически перейти в статус cancelled.
• Для возврата создайте оплаченный заказ и вызовите функцию auto_refund_order($order_id). Проверьте, что возврат средств прошел, а статус заказа изменился на refunded.
• Проверьте логи ошибок (wp-content/debug.log), если что-то пошло не так.

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

• Крон-задача не запускается: Убедитесь, что WordPress Cron включен и правильно работает на сервере. Для теста вызовите функцию вручную.
• Неправильные статусы заказов в фильтре: Используйте точные статусы WooCommerce: pending, on-hold, processing, completed, cancelled, refunded.
• Ошибка возврата средств: Проверьте, поддерживает ли платежный шлюз автоматические возвраты через WooCommerce API. Некоторые шлюзы требуют ручного подтверждения.
• Отсутствие уведомлений клиенту: Добавьте вызов стандартных уведомлений WooCommerce при изменении статуса или возврате через wc()->mailer()->emails.

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

• Запускайте крон-задачи вне пиковых нагрузок для минимизации влияния на производительность.
• Ограничьте объем обрабатываемых заказов в одном цикле, если база большая, добавив пагинацию или лимиты.
• Используйте nonce и проверки прав при вызове функций вручную через AJAX или админку.
• Журналируйте все автоматические действия для аудита и отладки.

Сравнение подходов: плагин vs код vs компромисс