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

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

В стандартной установке WooCommerce возврат денег (refund) обычно требует ручного подтверждения и действий администратора. При большом количестве заказов или частых возвратах это становится проблемой. Задача — автоматизировать возврат средств по определённым причинам (например, товар повреждён, не пришёл в срок), чтобы сэкономить время и снизить ошибки.

Основные признаки необходимости автоматизации:

• Высокий процент возвратов по одинаковым причинам
• Задержки с обработкой возвратов
• Частые ошибки при ручной обработке

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

Шаг 1. Добавляем пользовательское поле для выбора причины возврата в админке заказа

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

add_action('woocommerce_admin_order_data_after_order_details', function($order){
    woocommerce_wp_select(array(
        'id' => '_return_reason',
        'label' => 'Причина возврата',
        'options' => array(
            '' => 'Выберите причину',
            'damaged' => 'Товар повреждён',
            'late_delivery' => 'Доставка с опозданием',
            'wrong_item' => 'Неправильный товар',
            'other' => 'Другое'
        )
    ));
});

add_action('woocommerce_process_shop_order_meta', function($order_id){
    if (isset($_POST['_return_reason'])) {
        update_post_meta($order_id, '_return_reason', sanitize_text_field($_POST['_return_reason']));
    }
});

Шаг 2. Создаем функцию автоматического возврата при обновлении заказа

Добавим обработчик, который при сохранении заказа проверит причину возврата и статус заказа. Если причина подходит, автоматически создаст возврат и изменит статус заказа на "refunded".

add_action('woocommerce_process_shop_order_meta', function($order_id){
    $order = wc_get_order($order_id);
    $reason = get_post_meta($order_id, '_return_reason', true);

    if (!$reason) return; // причина не выбрана
    if ($order->get_status() === 'refunded') return; // уже возвращён

    $eligible_reasons = ['damaged', 'late_delivery']; // причины для авто-возврата
    if (!in_array($reason, $eligible_reasons)) return;

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

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

    // Меняем статус заказа
    $order->update_status('refunded', 'Автоматический возврат по причине: '.$reason);
    $order->save();
});

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

1. Создайте тестовый заказ и оплатите его.

2. В административной панели перейдите к заказу, выберите причину возврата из списка "Товар повреждён" или "Доставка с опозданием".

3. Сохраните заказ. Если все настроено правильно, средства будут автоматически возвращены, а статус заказа изменится на "refunded".

4. Проверьте записи возвратов в WooCommerce и логи ошибок (wp-content/debug.log), если включена отладка.

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

• Автоматический возврат не срабатывает: Проверьте, что причина возврата выбрана и входит в список $eligible_reasons. Проверьте правильность хуков.
• Возврат создается, но статус не меняется: Убедитесь, что метод update_status() вызывается после успешного возврата и что нет конфликтов с другими плагинами.
• Возврат не проходит по платёжной системе: Для некоторых шлюзов возврат требует дополнительной настройки или API-ключей. Проверьте документацию платежного плагина.
• Ошибки в логах: Включите WP_DEBUG и WP_DEBUG_LOG для выявления ошибок.

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

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

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