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

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

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

Основные причины ситуации:

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

Пошаговое решение автоматизации возврата средств при отмене оплаты

1. Проверка платёжного шлюза на поддержку возврата средств через API

Убедитесь, что используемый шлюз (например, Stripe, PayPal) поддерживает автоматические возвраты через API. Если нет — автоматизация невозможна без кастомной доработки.

2. Создание пользовательской функции для обработки возврата

Добавим в functions.php дочерней темы или в собственный плагин код, который будет реагировать на смену статуса заказа и запускать возврат.

add_action('woocommerce_order_status_cancelled', 'auto_refund_on_cancelled_status');

function auto_refund_on_cancelled_status($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Проверяем, был ли заказ оплачен
    if ($order->get_payment_method() === 'stripe' && $order->get_total() > 0) {
        $payment_id = $order->get_transaction_id();
        if (!$payment_id) return;

        // Подключаем Stripe SDK и инициализируем
        if (!class_exists('\Stripe\Stripe')) {
            require_once 'path/to/stripe-php/init.php';
        }
        \Stripe\Stripe::setApiKey('sk_test_...');

        try {
            $refund = \Stripe\Refund::create([
                'charge' => $payment_id,
                'amount' => intval($order->get_total() * 100), // сумма в центах
            ]);
            error_log('Refund successful for order ' . $order_id);
        } catch (Exception $e) {
            error_log('Refund failed for order ' . $order_id . ': ' . $e->getMessage());
        }
    }
}

В этом примере приведён код для Stripe. Для других шлюзов логика аналогична, но необходимо использовать их SDK и методы.

3. Запуск возврата при смене статуса заказа

Хук woocommerce_order_status_cancelled срабатывает при переводе заказа в статус «Отменён». Можно использовать и другие статусы по необходимости, например woocommerce_order_status_failed.

4. Логирование действий

Для отладки и проверки работы функции используйте error_log или сторонние плагины для логирования (например, WP Log Viewer), чтобы удостовериться, что возврат запускается.

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

1. Создайте тестовый заказ в WooCommerce и оплатите его через настроенный платёжный шлюз.
2. В административной панели измените статус заказа на «Отменён».
3. Проверьте логи сервера на наличие сообщений об успешном запуске возврата.
4. Убедитесь, что средства действительно возвращены на счёт клиента через интерфейс платёжного шлюза.

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

• Нет транзакционного ID: Если функция $order->get_transaction_id() возвращает null, возврат не будет выполнен. Проверьте, что платёжный шлюз передаёт корректный ID транзакции.
• Отсутствие SDK платёжного шлюза: Не забудьте подключить SDK (например, Stripe PHP), иначе функции возврата не сработают.
• Ошибки прав доступа: Проверьте, что API-ключи платёжного шлюза корректны и имеют права на выполнение возвратов.
• Неправильный формат суммы: Многие API требуют сумму возврата в центах или минимальных единицах, не забудьте конвертировать.
• Хук срабатывает несколько раз: Добавьте дополнительные проверки, чтобы не делать возврат дважды, например, проверяйте наличие уже сделанного возврата.

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

• Храните API-ключи платёжных систем в wp-config.php или в защищённых переменных окружения, а не в открытом коде.
• Используйте transient-кеши или опции для отслеживания уже выполненных возвратов, чтобы избежать дублей.
• Логируйте ошибки возврата в отдельный файл или сервис (Sentry, Loggly) для быстрого реагирования.
• Не запускайте возврат на фронтенде, только через серверные хуки, чтобы избежать злоупотреблений.
• Регулярно обновляйте SDK платёжных систем для совместимости и безопасности.

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