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

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

В стандартной установке WooCommerce возврат средств за отменённые заказы не происходит автоматически. Это связано с тем, что процесс возврата требует подтверждения и зависит от выбранного способа оплаты. Владельцы магазинов часто сталкиваются с ситуацией, когда заказ отменён, но деньги не возвращены покупателю, что негативно сказывается на репутации и ведёт к дополнительной нагрузке на службу поддержки.

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

• Перейти в WooCommerce → Заказы и найти отменённые заказы.
• Проверить, выполнен ли возврат по этим заказам (статус возврата в Meta или комментарии к заказу).
• Посмотреть логи платежного шлюза (WooCommerce → Статус → Логи) на наличие ошибок при попытке возврата.

Пошаговое решение: автоматизация возврата денег через хуки WooCommerce

1. Настройка статуса заказа для автоматического возврата

Добавим обработчик, который при смене статуса заказа на "отменён" будет инициировать возврат средств через API платежного шлюза или встроенный механизм WooCommerce.

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

    // Проверяем, что заказ оплачен
    if ($order->get_payment_method() === 'bacs' || $order->get_total() == 0) {
        // Возврат невозможен для безналичного способа или нулевой суммы
        return;
    }

    // Проверяем, был ли уже выполнен возврат
    if ($order->get_status() === 'refunded') return;

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

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

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

Не все платежные методы позволяют совершать возвраты программно. Для банковских переводов (bacs) и платежей при доставке возврат через API невозможен. Для популярных шлюзов (Stripe, PayPal) функцию wc_create_refund поддерживают, но требуется корректная настройка API-ключей и разрешений.

3. Логирование возвратов для контроля

Чтобы отслеживать успешность возвратов, добавим запись в системный лог:

if (!is_wp_error($refund)) {
    error_log('Автоматический возврат выполнен для заказа ' . $order_id);
}

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

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

1. Создайте тестовый заказ с оплатой через поддерживаемый шлюз (например, Stripe в тестовом режиме).
2. Оплатите заказ и подтвердите статус "обработан" или "выполнен".
3. В админке измените статус заказа на "отменён" вручную.
4. Проверьте, что возврат средств появился в системе платежей (панель Stripe/PayPal) и что в WooCommerce заказ отмечен как "refunded".
5. Проверьте логи ошибок PHP (error_log) на предмет записей о возврате.

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

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

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

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

Сравнение подходов к автоматическому возврату