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

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

Проблемы с автоматическим обновлением статуса оплаты заказа чаще всего возникают из-за некорректной интеграции платёжного шлюза, ошибок в обработчиках webhook, или конфликтов с кеширующими плагинами. Чтобы точно диагностировать проблему, проверьте следующие моменты:

• Есть ли у платёжного шлюза корректно настроенный URL для webhook (обратного вызова)?
• Логируются ли входящие webhook-события в WooCommerce?
• Отсутствуют ли ошибки PHP в логах сервера, связанные с обработкой webhook?
• Не мешают ли кеширующие плагины обновлению статуса (например, WP Super Cache, W3 Total Cache)?

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

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

1. Включите логирование WooCommerce для платежей

Перейдите в WooCommerce → Настройки → Платежи → выберите ваш шлюз → Включите логирование. Это поможет отследить события и ошибки.

2. Проверьте и настройте webhook в платёжном сервисе

В панели платёжного шлюза укажите правильный URL webhook:

https://yourdomain.com/?wc-api=WC_Gateway_YourGateway

Замените yourdomain.com и WC_Gateway_YourGateway на свои данные. Проверьте, что webhook активен и отправляет события о платёжных статусах.

3. Добавьте обработку webhook вручную (если плагин шлюза не обрабатывает корректно)

Если автоматическая обработка не работает, можно добавить собственный хук в functions.php вашей темы:

add_action('woocommerce_api_my_custom_gateway', 'handle_custom_gateway_webhook');
function handle_custom_gateway_webhook() {
    $payload = @file_get_contents('php://input');
    $data = json_decode($payload, true);
    if (! $data) {
        status_header(400);
        exit('Invalid payload');
    }

    $order_id = isset($data['order_id']) ? intval($data['order_id']) : 0;
    $payment_status = isset($data['status']) ? sanitize_text_field($data['status']) : '';

    if (!$order_id || !$payment_status) {
        status_header(400);
        exit('Missing data');
    }

    $order = wc_get_order($order_id);
    if (!$order) {
        status_header(404);
        exit('Order not found');
    }

    if ($payment_status === 'paid') {
        $order->payment_complete();
        $order->add_order_note('Статус оплаты обновлен через webhook.');
    } elseif ($payment_status === 'failed') {
        $order->update_status('failed', 'Платёж не прошёл.');
    }

    status_header(200);
    exit('OK');
}

Далее настройте URL webhook в платёжном сервисе на https://yourdomain.com/wc-api/my_custom_gateway

4. Отключите кеширование для страниц оплаты и webhook

Добавьте исключения в настройки кеширующих плагинов, чтобы страницы с оплатой и обработчики webhook не кешировались.

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

• Сделайте тестовый платёж в режиме песочницы или на реальном заказе.
• Проверьте в WooCommerce, что статус заказа обновился корректно без ручного вмешательства.
• Посмотрите логи WooCommerce: в разделе WooCommerce → Статус → Логи выберите последние логи платежного шлюза.
• Проверьте, что webhook-события получают ответ 200 в панели платёжного сервиса.

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

• Webhook не вызывается или получает ошибку 404: Проверьте правильность URL и наличие хука woocommerce_api_*. Убедитесь, что ЧПУ (permalinks) включены.
• Статус заказа не меняется после webhook: Удостоверьтесь, что в обработчике вызвана функция $order->payment_complete() или $order->update_status() с правильными статусами.
• Кеширование блокирует обновление: Исключите из кеша страницы с оплатой и webhook URL.
• Отсутствие прав на изменение заказа: Проверьте, что выполнение кода происходит на уровне сервера с достаточными правами (например, код вызывается в правильном контексте WordPress).

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

• Проверяйте подпись или токен webhook, чтобы убедиться, что запросы приходят от платёжного провайдера.
• Используйте nonce или секретный ключ для верификации webhook.
• Логируйте только критичные данные, избегайте записи персональных данных клиентов в логи.
• Для больших магазинов с высокой нагрузкой отключайте кеширование только на минимально необходимых страницах.

Сравнение способов решения проблемы