Как использовать WooCommerce хуки для автоматизации обработки возвратов

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

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

Основные WooCommerce хуки для работы с возвратами

Для автоматизации возвратов полезно использовать следующие хуки:

• woocommerce_order_refunded — срабатывает после регистрации возврата (refund) на заказ.
• woocommerce_order_partially_refunded — когда возврат частичный.
• woocommerce_refund_created — при создании объекта возврата.

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

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

add_action('woocommerce_order_refunded', 'wp_host_send_refund_notification', 10, 2);
function wp_host_send_refund_notification($order_id, $refund_id) {
    $order = wc_get_order($order_id);
    $refund = wc_get_order($refund_id);
    $to = 'support@example.com';
    $subject = 'Заказ №' . $order_id . ' полностью возвращён';
    $message = 'Заказ #' . $order_id . ' был полностью возвращён. Сумма возврата: ' . wc_price($refund->get_amount()) . '.';
    wp_mail($to, $subject, $message);
}

Пошаговое решение: как настроить автоматизацию возвратов

1. Добавьте код с хуками в файл functions.php вашей дочерней темы или в отдельный плагин.
2. Настройте email для уведомлений или другие действия (логирование, изменение метаданных заказа).
3. Проверьте, что ваши возвраты создаются через WooCommerce админку или API.
4. Тестируйте на тестовом заказе возврат с полной и частичной суммой.

Пример: автоматическая смена статуса заказа на "возвращён" после полного возврата

add_action('woocommerce_order_refunded', 'wp_host_change_order_status_on_refund');
function wp_host_change_order_status_on_refund($order_id, $refund_id) {
    $order = wc_get_order($order_id);
    if ($order->get_total_refunded() >= $order->get_total()) {
        $order->update_status('refunded', 'Заказ полностью возвращён автоматически');
    }
}

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

Для проверки работоспособности:

• Создайте тестовый заказ в WooCommerce.
• Верните полную или частичную сумму через админку или API.
• Проверьте, что письма отправились (если настроено), а статус заказа сменился на refunded при полном возврате.
• Проверьте логи сервера и почты для подтверждения событий.

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

• Хук не срабатывает: Убедитесь, что возврат создаётся именно через WooCommerce, а не вручную в базе.
• Неверные параметры функции: Проверьте количество аргументов в add_action, например, для woocommerce_order_refunded их должно быть 2.
• Письма не отправляются: Проверьте настройки SMTP и функцию wp_mail. Используйте плагины типа WP Mail SMTP для диагностики.
• Статус не меняется: Удостоверьтесь, что статус refunded разрешён в WooCommerce (можно добавить через фильтр wc_order_statuses если нужно).

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

• Ограничьте действия хуков только для нужных заказов, чтобы не создавать нагрузку на сайт.
• Используйте транзакции или проверяйте успешность операций при обновлении статусов.
• Не отправляйте слишком много писем — добавьте фильтры или лимиты, чтобы избежать спама.
• Для масштабных магазинов рассмотрите очередь задач (WP-Cron или сторонние решения) для обработки возвратов в фоне.

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