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

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

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

Какие встроенные возможности WooCommerce поддерживают возврат средств

WooCommerce из коробки позволяет создавать возвраты (refunds) через админ-панель, но не автоматизирует процесс. Чтобы реализовать автоматический возврат, нужно использовать хуки и фильтры, либо дополнительные плагины. Важным условием является наличие интеграции с платёжным шлюзом, поддерживающим возвраты через API (например, Stripe, PayPal).

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

• Откройте WooCommerce > Настройки > Платежи
• Выберите ваш шлюз, например Stripe
• Убедитесь, что в документации к шлюзу указана поддержка API возвратов

Без поддержки API возвратов автоматизация невозможна.

Пошаговое решение: автоматический возврат по статусу заказа и времени

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

1. Добавление пользовательского cron-задания

add_action('wp', function() {
    if (!wp_next_scheduled('auto_refund_orders_event')) {
        wp_schedule_event(time(), 'hourly', 'auto_refund_orders_event');
    }
});

2. Хук обработки cron-события

add_action('auto_refund_orders_event', function() {
    $args = [
        'limit' => -1,
        'status' => 'cancelled',
        'date_modified' => '<' . (time() - DAY_IN_SECONDS),
    ];
    $orders = wc_get_orders($args);

    foreach ($orders as $order) {
        if (!$order->has_status('refunded')) {
            $refund = wc_create_refund([
                'amount' => $order->get_total(),
                'reason' => 'Автоматический возврат по правилу 24 часа',
                'order_id' => $order->get_id(),
            ]);
            if (is_wp_error($refund)) {
                error_log('Ошибка возврата для заказа ' . $order->get_id() . ': ' . $refund->get_error_message());
            } else {
                $order->update_status('refunded', 'Автоматический возврат завершён');
            }
        }
    }
});

3. Очистка cron при деактивации темы или плагина

register_deactivation_hook(__FILE__, function() {
    wp_clear_scheduled_hook('auto_refund_orders_event');
});

Как проверить, что автоматический возврат работает

• Создайте тестовый заказ в статусе cancelled и выставьте дату изменения более суток назад через базу данных или phpMyAdmin.
• Запустите cron вручную через WP-CLI: wp cron event run auto_refund_orders_event
• Проверьте, что статус заказа изменился на refunded, а возврат создан в админке WooCommerce.
• Посмотрите логи ошибок, если возврат не произошёл.

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

• Отсутствие поддержки возвратов в платёжном шлюзе: автоматический возврат не пройдет. Проверьте документацию и настройки платежей.
• Неправильный формат дат в запросе заказов: параметр date_modified должен быть в формате MySQL ('Y-m-d H:i:s'), а не timestamp. Исправьте код так:

  'date_modified' => '<' . date('Y-m-d H:i:s', time() - DAY_IN_SECONDS),

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

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

• Используйте nonce и проверяйте права пользователя при добавлении интерфейсов для возвратов.
• Ограничьте количество обрабатываемых заказов за один запуск cron (например, 10 штук), чтобы избежать тайм-аутов.
• Логируйте ошибки возврата для дальнейшей отладки.
• Регулярно проверяйте работу cron и состояние платежного шлюза.

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