WooCommerce: автоматизация возврата и отмены заказов через вебхуки

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

В стандартном WooCommerce возврат и отмена заказов зачастую требуют ручного вмешательства администратора. При работе с большим количеством заказов это увеличивает нагрузку и может привести к ошибкам, например, если возврат не оформлен вовремя или заказ не отменён после проблем с оплатой.

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

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

• Частые задержки с возвратами и отменами заказов.
• Ошибки в учёте возвратов при большом потоке заказов.
• Ручное оформление возвратов занимает много времени.
• Отсутствие уведомлений для клиентов о статусе возврата или отмены.

Как настроить вебхуки WooCommerce для возврата и отмены заказов

Создание вебхука в админке WooCommerce

Перейдите в WooCommerce > Настройки > Продвинутые > Вебхуки и нажмите «Добавить вебхук».

Настройки вебхука:

• Название: Return and Cancel Automation
• Статус: Активен
• Тема: order.refunded и order.cancelled (нужно создать два вебхука или один с фильтрацией на стороне сервера)
• URL доставки: URL вашего обработчика на сервере (например, https://example.com/wp-json/custom/v1/order-webhook)
• Секрет: любой сложный ключ для проверки подписи

Пример простого обработчика вебхука на PHP

add_action('rest_api_init', function () {
    register_rest_route('custom/v1', '/order-webhook', array(
        'methods' => 'POST',
        'callback' => 'handle_order_webhook',
        'permission_callback' => '__return_true',
    ));
});

function handle_order_webhook(WP_REST_Request $request) {
    $data = json_decode($request->get_body(), true);
    $event_type = $request->get_header('X-WC-Webhook-Topic');
    $order_id = $data['id'] ?? 0;

    if (!$order_id) {
        return new WP_REST_Response('Order ID missing', 400);
    }

    $order = wc_get_order($order_id);
    if (!$order) {
        return new WP_REST_Response('Order not found', 404);
    }

    switch ($event_type) {
        case 'order.refunded':
            // Автоматически обновим статус заказа и отправим уведомление
            $order->update_status('refunded', 'Автоматический возврат через вебхук');
            // Тут можно добавить логику возврата денег через API платежной системы
            break;

        case 'order.cancelled':
            $order->update_status('cancelled', 'Автоматическая отмена через вебхук');
            // Дополнительные действия при отмене
            break;

        default:
            return new WP_REST_Response('Unhandled event type', 400);
    }

    return new WP_REST_Response('Success', 200);
}

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

• Создайте тестовый заказ и инициируйте возврат или отмену через платежную систему или админку.
• Проверьте, что вебхук срабатывает — в логах сервера или с помощью плагина для логирования запросов (например, Clearfy Pro имеет инструменты для логов).
• Убедитесь, что статус заказа в WooCommerce меняется автоматически на refunded или cancelled.
• Проверьте, что клиент получает уведомление (если настроена рассылка WooCommerce).

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

• Неправильный URL вебхука или недоступность сервера: используйте curl или Postman, чтобы проверить доступность URL.
• Отсутствует проверка подписи вебхука: реализуйте проверку секретного ключа, чтобы избежать подделки запросов.
• Неправильный обработчик REST API: убедитесь, что маршрут зарегистрирован правильно и метод permission_callback не блокирует доступ.
• Не обновляется статус заказа: проверьте, что ID заказа из данных совпадает с реальным заказом, и используйте правильные методы WooCommerce.
• Конфликты с другими плагинами: временно отключите плагины кеширования и безопасности для диагностики.

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

• Всегда проверяйте подпись вебхука через заголовок X-WC-Webhook-Signature, чтобы исключить подделку.
• Логируйте входящие запросы и ответы, чтобы быстро выявлять проблемы.
• Используйте асинхронную обработку тяжелых задач (например, возврат денег через платежный API) через WP-Cron или внешние очереди.
• Оптимизируйте код обработчика, избегайте долгих синхронных операций.
• Регулярно обновляйте WooCommerce и плагины для поддержки безопасности вебхуков.

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