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

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

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

Проблемы, которые решает автоматический возврат:

• Задержка с возвратом денег после отмены заказа.
• Пропущенные возвраты из-за человеческого фактора.
• Сложность контроля статусов и условий возврата.

Как настроить автоматический возврат средств в WooCommerce

Особенности API возвратов WooCommerce

WooCommerce хранит заказы как объекты WC_Order. Для возврата используется метод refund() класса WC_Order. Для создания возврата необходимо сформировать объект WC_Order_Refund.

Пошаговое решение на примере автоматического возврата при смене статуса заказа на "Отменён"

add_action('woocommerce_order_status_cancelled', 'auto_refund_on_cancelled', 10, 1);
function auto_refund_on_cancelled($order_id) {
    $order = wc_get_order($order_id);
    if (!$order || $order->get_total_refunded() > 0) {
        return; // Уже есть возврат или заказ не найден
    }

    // Проверяем, что заказ оплачен
    if (!$order->is_paid()) {
        return; // Нет смысла делать возврат
    }

    $refund_amount = $order->get_total() - $order->get_total_refunded();
    if ($refund_amount <= 0) {
        return; // Нет суммы для возврата
    }

    $refund = wc_create_refund(array(
        'amount'     => $refund_amount,
        'reason'     => 'Автоматический возврат при отмене заказа',
        'order_id'   => $order_id,
        'refund_payment' => true, // Попытка вернуть через платежный шлюз
    ));

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

Альтернативы: возврат по расписанию через WP-Cron

Если возвраты нужно делать не сразу, а через время (например, после 24 часов без оплаты), можно использовать WP-Cron с отложенной задачей:

function schedule_refund_event($order_id) {
    if (!wp_next_scheduled('auto_refund_event', array($order_id))) {
        wp_schedule_single_event(time() + 86400, 'auto_refund_event', array($order_id));
    }
}
add_action('auto_refund_event', 'auto_refund_on_cancelled');

add_action('woocommerce_order_status_pending_to_cancelled', function($order_id) {
    schedule_refund_event($order_id);
});

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

• Создайте тестовый заказ с оплатой (лучше в режиме песочницы платежного шлюза).
• Измените статус заказа на "Отменён" через админку или программно.
• Проверьте, что в разделе возвратов WooCommerce появился возврат на сумму заказа.
• Убедитесь, что деньги вернулись на платёжный метод (для песочницы — смотрите логи или интерфейс).
• Просмотрите журнал ошибок PHP и WooCommerce на предмет предупреждений.

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

• Ошибка: Возврат не создаётся и нет ошибок.
  Причина: Метод wc_create_refund() не вызывается из-за условий проверки или неправильного статуса.
  Решение: Добавьте логирование и проверьте, что код срабатывает.
• Ошибка: Возврат создаётся, но деньги не возвращаются.
  Причина: Платёжный шлюз не поддерживает автоматический возврат через API.
  Решение: Проверьте документацию платежного шлюза. Для некоторых шлюзов требуется ручная обработка.
• Ошибка: Повторные возвраты на один заказ.
  Причина: Нет проверки суммы уже возвращённых средств.
  Решение: Используйте метод get_total_refunded() для проверки.
• Ошибка: WP-Cron не срабатывает.
  Причина: На хостинге отключены WP-Cron или малый трафик.
  Решение: Используйте системный cron или тестируйте вручную.

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

• Безопасность: Всегда проверяйте, что заказ оплачен перед возвратом, чтобы избежать ошибок и мошенничества.
• Логи и мониторинг: Включите логирование ошибок возврата через error_log() или специальный плагин для отладки WooCommerce.
• Производительность: Не создавайте возвраты в хуках с высокой частотой без условий, чтобы не перегружать сервер.
• Проверка платежных шлюзов: Убедитесь, что ваши шлюзы поддерживают автоматические возвраты, иначе дополнительно настройте уведомления и ручные процедуры.

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