WooCommerce: автоматическое возврат средств при отмене заказа с помощью хуков

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

В стандартной установке WooCommerce возврат средств (refund) не происходит автоматически при отмене заказа. Владельцы магазинов вынуждены делать это вручную, что увеличивает операционные расходы и может привести к ошибкам. Задача — настроить автоматический возврат средств при отмене заказа через код, используя хуки WooCommerce.

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

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

• Статус cancelled — заказ отменён, но возврат средств не инициируется автоматически.
• Функция возврата требует вызова методов $order->refund() или создания объекта возврата через WC_Order_Refund.
• Стандартные хуки woocommerce_order_status_changed или woocommerce_order_status_cancelled позволяют реагировать на смену статуса.

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

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

1. Подключение к хуку смены статуса заказа

Добавим функцию в functions.php темы или в кастомный плагин, которая будет реагировать на смену статуса заказа на cancelled:

add_action('woocommerce_order_status_cancelled', 'auto_refund_on_order_cancelled', 10, 1);
function auto_refund_on_order_cancelled($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);

    // Проверяем, что заказ оплачен и ещё не возвращён
    if ($order->get_status() !== 'cancelled' || $order->get_total_refunded() > 0) {
        return;
    }

    // Создаём возврат
    $refund_amount = $order->get_total() - $order->get_total_refunded();
    if ($refund_amount <= 0) {
        return;
    }

    $refund = wc_create_refund(array(
        'amount' => $refund_amount,
        'reason' => 'Автоматический возврат при отмене заказа',
        'order_id' => $order_id,
        'refund_payment' => true,
    ));

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

2. Проверка поддержки возвратов платежным шлюзом

Автоматический возврат сработает, только если используемый платежный шлюз поддерживает возвраты через WooCommerce (например, Stripe, PayPal). Для проверки:

• Откройте заказ в админке WooCommerce.
• Убедитесь, что есть кнопка «Возврат» (Refund) в действиях платежа.
• Проверьте работу ручного возврата.

3. Тестирование на тестовом заказе

Создайте тестовый заказ, оплатите его тестовым способом, затем измените статус на cancelled. Проверьте, что возврат создаётся автоматически и средства возвращаются.

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

• В админке WooCommerce зайдите в раздел заказов.
• Выберите заказ со статусом cancelled.
• Проверьте, что сумма возврата в заказе не равна нулю.
• Проверьте логи ошибок в wp-content/debug.log при включённом WP_DEBUG.

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

• Ошибка: возврат не создаётся, хотя статус изменён.
  Причина: платежный шлюз не поддерживает автоматические возвраты или отключена опция возврата в настройках. Решение: проверить документацию платежного шлюза, обновить настройки, либо отключить автоматизацию.
• Ошибка: возврат создаётся, но сумма равна 0.
  Причина: в заказе уже есть возврат или сумма неверно вычисляется.
  Решение: добавить проверку $order->get_total_refunded() и отладить логи.
• Ошибка: PHP предупреждения или фатальные ошибки.
  Причина: устаревший WooCommerce или конфликт плагинов.
  Решение: обновить все компоненты, проверить совместимость, отключить плагины по очереди.

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

• Добавляйте возврат только после проверки, что заказ действительно оплачен и что возврат ещё не осуществлён, чтобы избежать двойных возвратов.
• Логируйте ошибки возврата в отдельный файл или системный лог для последующего анализа.
• Если возвраты занимают много времени, рассмотреть выполнение кода через WP-Cron с задержкой, чтобы не блокировать работу сайта при смене статуса.
• Тестируйте на staging-среде перед внедрением на боевом сайте.

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