WooCommerce: автоматическое обновление статуса заказа при оплате через платёжные системы

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

Частая проблема в WooCommerce — заказ не меняет статус после успешной оплаты через внешние платёжные системы (например, Яндекс.Касса, Robokassa, PayPal, Stripe). Это приводит к тому, что покупатель видит заказ в статусе «Ожидание оплаты» или «В обработке», хотя деньги уже получены. Часто причина в отсутствии корректной обратной связи от платёжного шлюза или неправильно настроенных вебхуках.

Чтобы проверить, есть ли проблема с обновлением статуса:

• Зайдите в WooCommerce > Заказы и найдите заказ, который вы оплатили.
• Посмотрите текущий статус заказа — если он не изменился на «Завершён» или «Обрабатывается», есть проблема.
• Проверьте логи плагина платёжной системы (если есть) и системные логи WooCommerce в WooCommerce > Статус > Логи.

Почему WooCommerce не обновляет статус заказов автоматически

Отсутствие или неправильная настройка IPN/webhook

Большинство платёжных систем используют Instant Payment Notification (IPN) или webhooks, чтобы сообщить сайту о смене статуса платежа. Если URL для уведомлений не прописан или обработчик не настроен — WooCommerce не узнает об успешной оплате.

Конфликты с плагинами или темой

Некорректно работающие плагины или кастомные функции могут блокировать изменение статуса.

Проблемы с кэшированием

Кэширование на уровне сервера или плагинов может задерживать обновление данных.

Пошаговое решение проблемы автоматического обновления статуса

1. Проверка настроек платёжного шлюза

Убедитесь, что в кабинете платёжной системы настроен правильный URL для уведомлений. Например, для PayPal это https://example.com/?wc-api=WC_Gateway_Paypal.

2. Настройка вебхуков вручную в WooCommerce

WooCommerce позволяет создавать вебхуки в WooCommerce > Настройки > Расширенные > Вебхуки. Создайте новый вебхук, укажите адрес приёма уведомлений, выберите событие order.updated или order.payment_completed, и подключите его к платёжной системе.

3. Добавление пользовательского обработчика для платёжной системы

Если платёжка не интегрирована или webhook не работает, можно добавить кастомный обработчик. Пример для обработки уведомления от платёжной системы с обновлением статуса:

add_action('init', 'custom_payment_notification_handler');
function custom_payment_notification_handler() {
    if (!isset($_GET['custom_payment_notify'])) {
        return;
    }
    $order_id = intval($_GET['order_id']);
    $payment_status = sanitize_text_field($_GET['status']);
    if (!$order_id || !$payment_status) {
        status_header(400);
        exit('Invalid data');
    }
    $order = wc_get_order($order_id);
    if (!$order) {
        status_header(404);
        exit('Order not found');
    }
    if ($payment_status === 'success') {
        $order->update_status('processing', 'Оплата успешно получена через кастомный обработчик.');
        echo 'OK';
        exit;
    } else {
        status_header(400);
        exit('Payment failed');
    }
}

В этом примере мы слушаем GET-запрос с параметрами custom_payment_notify, order_id и status, чтобы обновить статус заказа.

4. Очистка кэша и тестирование

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

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

• Создайте тестовый заказ и оплатите через выбранную платёжную систему.
• Проверьте, что статус заказа автоматически изменился на «Обрабатывается» или «Завершён».
• Если используется кастомный обработчик, перейдите по специальному URL с параметрами и убедитесь, что статус обновился.
• Посмотрите логи WooCommerce на предмет ошибок.

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

• Неправильный URL webhook: убедитесь, что URL точно совпадает с адресом сайта и содержит нужные параметры.
• Плагин платёжной системы отключён или конфликтует: временно деактивируйте другие плагины, чтобы проверить совместимость.
• Отсутствие проверки nonce или безопасности в кастомном коде: при добавлении кастомного обработчика обязательно валидируйте входящие данные и применяйте меры безопасности.
• Кэширование данных: отключите кэширование страниц для страниц с заказами или исключите URL webhook из кэширования.

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

• Для кастомных webhook-обработчиков всегда проверяйте подлинность запроса (например, подпись или секретный ключ в параметрах).
• Используйте HTTPS для всех URL уведомлений, чтобы исключить MITM-атаки.
• При большом количестве заказов используйте WP-CLI или cron-задачи для периодической проверки статусов на стороне сервера.
• Для производительности избегайте излишних запросов к базе — кешируйте ответы с платёжных API, если это возможно.

Сравнение вариантов решения