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

Проблема: необходимость автоматизировать возврат средств при отмене заказа в WooCommerce

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

Диагностика проблемы

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

• Перейдите в админку WooCommerce → Заказы;
• Откройте отменённый заказ;
• Проверьте, был ли создан возврат средств (refund) автоматически;
• Если возврат не создавался, значит нужна автоматизация.

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

1. Использование хука для автоматической обработки возврата при смене статуса заказа

Добавим в functions.php активной темы следующий код, который будет запускать возврат средств, когда заказ меняет статус на "cancelled" (отменён):

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

    // Проверяем, есть ли уже возврат
    $has_refund = false;
    foreach ($order->get_refunds() as $refund) {
        $has_refund = true;
        break;
    }
    if ($has_refund) return; // Возврат уже сделан

    // Получаем платежные данные
    $payment_method = $order->get_payment_method();

    // Автоматический возврат возможен только для некоторых методов
    $supported_methods = array('stripe', 'paypal'); // добавьте свои методы
    if (!in_array($payment_method, $supported_methods)) return;

    // Создаём возврат
    $amount_to_refund = $order->get_total();
    if ($amount_to_refund <= 0) return;

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

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

2. Настройка поддержки платежных шлюзов

В коде выше список $supported_methods определяет, для каких платежных методов срабатывает автоматический возврат. Убедитесь, что используемые в магазине шлюзы поддерживают программные возвраты через WooCommerce. Например, для Clearfy Pro есть интеграции с популярными шлюзами, упрощающими такие задачи.

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

• Отмените тестовый заказ (установите статус как "Отменён");
• Проверьте, появился ли возврат в заказе, в разделе "Возвраты";
• Убедитесь, что сумма возврата совпадает с суммой заказа;
• Проверьте логи ошибок в wp-content/debug.log (если включено логирование ошибок). Если ошибок нет – код сработал корректно.

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

• Возврат не создаётся: Проверьте, что платежный метод поддерживает возврат через WooCommerce API и что он указан в $supported_methods.
• Ошибка «refund_payment»: Убедитесь, что в настройках платежного шлюза разрешены программные возвраты и что ключи API верны.
• Возврат создаётся несколько раз: Код проверяет наличие возвратов, но если эта проверка удалена или изменена, возвращайте её.
• Ошибка прав доступа: Добавьте define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); в wp-config.php и изучите логи для диагностики.

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

• Не используйте автоматический возврат для всех платежных методов без проверки возможности API – это может привести к ошибкам и блокировкам.
• Логируйте ошибки возврата для оперативного мониторинга проблем.
• Ограничивайте автоматические операции тяжелыми проверками — например, только для заказов с успешной оплатой.
• Резервное копирование базы данных перед внедрением автоматизации возвратов обязательно.

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