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

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

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

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

1. Выбор события для запуска возврата

Оптимально использовать хук woocommerce_order_status_changed, который срабатывает при смене статуса заказа. Например, при переходе заказа в статус refunded можно автоматически инициировать возврат средств.

2. Добавление кода в functions.php или в кастомный плагин

Ниже пример кода, который автоматически запускает возврат денег через API WooCommerce при смене статуса заказа на refunded:

add_action('woocommerce_order_status_changed', 'auto_process_refund_on_status_change', 10, 3);
function auto_process_refund_on_status_change($order_id, $old_status, $new_status) {
    if ($new_status === 'refunded') {
        $order = wc_get_order($order_id);
        if (!$order) return;

        // Проверяем, что возврат еще не создан
        if (count($order->get_refunds()) > 0) return;

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

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

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

Перейдите в админку WooCommerce, найдите заказ и измените его статус на refunded. После сохранения проверьте, создался ли возврат и поступили ли деньги обратно (в зависимости от платежного шлюза).

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

• В админке заказа должен появиться возврат с указанной суммой.
• Платежный шлюз должен подтвердить возврат (логи или панель платёжной системы).
• В логе ошибок WordPress не должно быть сообщений о проблемах с возвратом.

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

• Возврат не создается: проверьте, что сумма возврата не превышает остаток к возврату по заказу.
• Возврат создается, но деньги не возвращаются: убедитесь, что платежный шлюз поддерживает автоматические возвраты через API WooCommerce.
• Ошибка «refund_payment»: в некоторых случаях API платежного шлюза требует дополнительной аутентификации или настроек в WooCommerce.
• Двойной возврат: добавьте проверку наличия уже созданных возвратов, как в примере выше.

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

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

Сравнение вариантов реализации возврата