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

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

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

Как программно автоматизировать возврат средств и смену статуса заказа

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

Для автоматизации нам понадобятся функции класса WC_Order, а именно:

• $order->refund() — для создания возврата (refund) денежных средств;
• $order->update_status() — для смены статуса заказа;
• Хук woocommerce_order_status_changed — для выполнения действий при смене статуса заказа;
• Функции работы с платежными шлюзами, если возврат требует взаимодействия с API платёжной системы.

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

Допустим, мы хотим автоматически вернуть средства и перевести заказ в статус refunded, если заказ находится в статусе processing и прошло более 7 дней с даты оплаты.

function auto_refund_orders_after_7_days() {
    $args = [
        'limit' => -1,
        'status' => 'processing',
        'date_paid' => '<=' . ( time() - 7 * 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' => 'Автоматический возврат после 7 дней',
                'order_id' => $order->get_id(),
                'refund_payment' => true,
            ]);

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

            $order->update_status('refunded', 'Автоматический возврат выполнен');
        }
    }
}

add_action('woocommerce_scheduled_sales', 'auto_refund_orders_after_7_days');

В этом примере используется хук woocommerce_scheduled_sales для примера запуска, на практике лучше назначить свой Cron-задачу.

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

1. Создайте WP-Cron задачу: добавьте в файл functions.php или в свой плагин регистрацию задачи, например, запуск раз в сутки.
2. Реализуйте функцию возврата: используйте wc_create_refund() для создания возврата по заказу.
3. Измените статус заказа: после успешного возврата вызовите $order->update_status('refunded').
4. Обработайте ошибки: логируйте ошибки возврата для отладки.
5. Тестируйте на тестовом магазине: создайте заказ, оплатите тестовым платежным методом, проверьте выполнение возврата и смену статуса после запуска Cron.

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

• Убедитесь, что в WooCommerce новая задача Cron появилась (можно с помощью плагина WP Crontrol).
• Создайте тестовый заказ со статусом processing и датой оплаты старше 7 дней.
• Запустите Cron вручную или дождитесь автоматического запуска.
• Проверьте в админке, что заказ переведён в статус refunded и создан возврат.
• Проверьте логи ошибок на предмет срабатывания функций.

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

• Возврат не создаётся, а статус меняется: убедитесь, что платежный метод поддерживает программный возврат, иначе wc_create_refund() вернёт ошибку.
• Cron-задача не запускается: проверьте регистрацию задачи и убедитесь, что WP-Cron работает (проверьте с помощью WP Crontrol или вызовите wp cron event run --due-now в консоли).
• Ошибка доступа к объекту заказа: используйте всегда wc_get_order($order_id), а не прямое создание объекта.
• Дублирование возвратов: добавьте проверку, что возврат по заказу ранее не был выполнен.

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

• Ограничьте права пользователей, которые могут запускать или изменять логику возвратов.
• Для массовых операций запускайте скрипт частями, чтобы избежать таймаутов.
• Логируйте все операции возврата и смены статусов для аудита.
• Если используете платёжные API для возвратов, храните ключи и токены в защищённых настройках.

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