WooCommerce: как добавить автоматическую обработку возвратов и возвратных платежей

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

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

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

Как WooCommerce обрабатывает возвраты из коробки

По умолчанию WooCommerce предоставляет статус refunded для заказов, которые были возвращены, и позволяет вводить возвраты через админку. Однако:

• Ручное обновление статусов и возврат денег — затратный процесс.
• Нет встроенной поддержки автоматической интеграции с платежными шлюзами для возвратов.
• Отсутствует автоматическое уведомление клиентов после возврата.

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

1. Отслеживаем запросы на возврат

Предположим, что у вас есть пользовательский механизм подачи запросов на возврат (например, отдельная форма или плагин). Для примера добавим обработчик, который запускается при изменении статуса заказа на refund_requested:

add_action('woocommerce_order_status_refund_requested', 'handle_refund_request');
function handle_refund_request($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Запускаем процесс возврата
    process_refund($order);
}

2. Функция автоматического возврата платежа через WooCommerce

WooCommerce имеет метод $order->refund() или можно использовать WC_Refund напрямую. Ниже пример, который создает возврат на всю сумму заказа и меняет статус заказа на refunded:

function process_refund($order) {
    // Получаем сумму заказа
    $total = $order->get_total();

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

    if (is_wp_error($refund)) {
        error_log('Ошибка возврата: ' . $refund->get_error_message());
        return;
    }

    // Обновляем статус заказа
    $order->update_status('refunded', 'Заказ автоматически возвращён');
}

3. Уведомление клиента и админа о возврате

Добавим отправку email клиенту после успешного возврата:

add_action('woocommerce_order_refunded', 'notify_refund_complete', 10, 2);
function notify_refund_complete($order_id, $refund_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    $mailer = WC()->mailer();
    $mails = $mailer->get_emails();

    if (!empty($mails['WC_Email_Customer_Refunded_Order'])) {
        $mails['WC_Email_Customer_Refunded_Order']->trigger($order_id, $refund_id);
    }
}

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

• Создайте тестовый заказ и вручную измените его статус на refund_requested (через админку или код).
• Проверьте, что возврат создан, заказ получил статус refunded.
• Убедитесь, что клиент получил уведомление о возврате.
• Проверьте логи ошибок (если возврат не прошёл) в wp-content/debug.log.

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

• Возврат не создаётся, ошибка платежного шлюза. Проверьте, поддерживает ли ваш шлюз API возвратов и правильно ли настроены ключи.
• Статус заказа не меняется. Убедитесь, что используете метод update_status() корректно и что нет конфликтов с другими плагинами.
• Письма не отправляются. Проверьте настройки email WooCommerce, а также наличие письма Customer Refunded Order.
• Возврат срабатывает несколько раз. Добавьте проверки, чтобы не запускать возврат повторно на одном заказе.

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

• Всегда проверяйте права пользователя, инициирующего возврат, чтобы избежать несанкционированных операций.
• Логируйте ошибки возврата для быстрого реагирования.
• Для больших магазинов используйте очередь задач (например, WP Cron или внешние сервисы) для обработки возвратов, чтобы не нагружать сервер.
• Регулярно обновляйте WooCommerce и платежные шлюзы, чтобы сохранить совместимость и безопасность.

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