WooCommerce: автоматическая обработка возвратов через код — практическое руководство

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

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

Что нужно для автоматической обработки возвратов

Для начала определимся, какие действия должны выполняться автоматически при возврате товара:

• Изменение статуса заказа на «Возврат» или «Возвращено»;
• Автоматический возврат средств через WooCommerce Refund API;
• Отправка уведомления клиенту о результате возврата;
• Логирование действий для последующего аудита.

Требования к окружению

• WooCommerce версии 4.0 и выше;
• PHP 7.4+;
• Доступ к файлу functions.php темы дочерней или собственного плагина для добавления кода.

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

1. Создание функции для обработки возврата

Добавьте следующий код в functions.php вашей дочерней темы или в собственный плагин:

function wpeasy_process_refund_automatically(\$order_id) {
    if (!\$order_id) {
        return;
    }
    
    \$order = wc_get_order(\$order_id);
    if (!\$order || !\$order->has_status('completed')) {
        return; // Обрабатывать только завершённые заказы
    }
    
    // Проверяем, есть ли возврат уже
    \$refunds = \$order->get_refunds();
    if (!empty(\$refunds)) {
        return; // Возврат уже обработан
    }

    // Создаём возврат на всю сумму
    \$amount = \$order->get_total();
    \$refund = wc_create_refund(array(
        'amount' => \$amount,
        'reason' => 'Автоматический возврат по запросу',
        'order_id' => \$order_id,
        'refund_payment' => true, // Возврат платежа
    ));

    if (is_wp_error(\$refund)) {
        error_log('Ошибка возврата WooCommerce: ' . \$refund->get_error_message());
        return;
    }
    
    // Меняем статус заказа
    \$order->update_status('refunded', 'Заказ автоматически возвращён');

    // Отправляем уведомление клиенту
    WC()->mailer()->customer_refunded_order(\$order, \$refund->get_id());
}

2. Запуск функции по событию

Чтобы функция запускалась автоматически, нужно определить событие, по которому происходит возврат. Например, при изменении статуса заказа на «processing» с определённым мета-полем, или при получении специального запроса через REST API. Для простоты примера запустим по хуку woocommerce_order_status_processing:

add_action('woocommerce_order_status_processing', 'wpeasy_process_refund_automatically');

В реальной ситуации подстройте триггер под ваши бизнес-процессы.

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

• Оформите тестовый заказ и перейдите к статусу «processing» вручную;
• Проверьте, что статус изменился на «refunded»;
• Убедитесь, что возвращена сумма (проверка в WooCommerce > Заказы > Возвраты);
• Проверьте почту клиента (или лог почты) на предмет уведомления о возврате;
• Посмотрите журнал ошибок PHP на предмет отсутствия ошибок.

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

• Возврат не создаётся: проверьте, что заказ в статусе, по которому срабатывает функция, и что сумма возврата не равна нулю.
• Ошибка «refund_payment»: убедитесь, что платежный шлюз поддерживает автоматические возвраты через API.
• Уведомление клиенту не отправляется: проверьте работу почтового сервера и функцию WC()->mailer()->customer_refunded_order.
• Несовпадение статусов: используйте правильные статусы WooCommerce: completed, processing, refunded.

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

• Добавляйте проверку nonce и прав доступа, если интегрируете с REST API или пользовательскими формами;
• Логируйте ошибки возврата в отдельный файл для удобного аудита;
• Не запускайте автоматический возврат без дополнительной валидации, чтобы избежать ошибочных операций;
• Для больших магазинов сделайте обработку возвратов асинхронной через WP Cron или очередь задач;
• Используйте дочернюю тему или собственный плагин для добавления кода, чтобы избежать потери изменений при обновлении.

Сравнение способов автоматизации возвратов