Отладка ошибок оплаты и обновление статуса заказов в WooCommerce

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

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

Для начала нужно понять, на каком этапе возникает сбой:

• Платеж не проходит — возможно, проблемы с настройками платежного шлюза или сетью.
• Статус заказа не обновляется после успешной оплаты — ошибка в хуках обработки статуса.
• Клиент не получает подтверждение — сбой в отправке email уведомлений.

Проверяем логи WooCommerce и сервера:

wp wc --debug log

Включите режим отладки в wp-config.php для подробного логирования:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

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

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

Перейдите в WooCommerce → Настройки → Платежи и убедитесь, что платежный шлюз активен и корректно настроен, включая URL обратного вызова (webhook) для обновления статуса.

2. Ручное отслеживание обновления статуса

Добавьте следующий код в файл functions.php вашей темы или в свой плагин, чтобы логировать смену статусов заказов:

add_action('woocommerce_order_status_changed', 'log_order_status_change', 10, 4);
function log_order_status_change($order_id, $old_status, $new_status, $order) {
    error_log("Order #$order_id status changed from $old_status to $new_status");
}

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

3. Принудительное обновление статуса заказа после успешной оплаты

Если платежный шлюз не обновляет статус автоматически, можно добавить обработчик webhook’а или cron-задачу для проверки статуса платежа и обновления заказа:

function update_order_status_after_payment($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Здесь ваша логика проверки платежа, например, запрос к API платежного шлюза
    $payment_status = check_payment_status_api($order_id); // функция-заглушка

    if ($payment_status === 'paid' && $order->get_status() !== 'processing') {
        $order->update_status('processing', 'Оплата подтверждена автоматически');
    }
}

// Пример вызова (можно по крону или вебхуку)
update_order_status_after_payment(1234);

В реальном проекте замените check_payment_status_api на реальный вызов к API вашего платежного провайдера.

Проверка результата

После внедрения кода и настроек:

• Совершите тестовый заказ с выбранным платежным методом.
• Убедитесь, что статус заказа меняется на processing или completed после оплаты.
• Проверьте логи ошибок и debug.log — не должно быть критических ошибок.
• Проверьте, что клиент получает уведомление по email (если настроена отправка).

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

• Неверный URL webhook’a
  Проверьте, что URL обратного вызова платежного шлюза совпадает с адресом вашего сайта и доступен без ограничений.
• Конфликты с кэшированием
  Кэширование страниц заказа или webhook’ов может блокировать обновление статусов. Для webhook’ов отключайте кэширование на уровне сервера или плагинов.
• Некорректные права доступа
  Проверьте, что ваш сервер и WordPress могут принимать запросы webhook. Иногда помогает добавление в .htaccess или настройка CORS.
• Отсутствие проверки nonce или авторизации в webhook
  Это может привести к ошибкам или безопасности. Используйте проверку подписи платежного провайдера.

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

• Всегда проверяйте подписи и токены в webhook-запросах, чтобы исключить подделку.
• Не выполняйте тяжелые операции в webhook-обработчиках — лучше ставьте задачи в очередь (WP Cron или внешние очереди).
• Отключайте кэширование на страницах, связанных с заказами и webhook.
• Логируйте только нужные данные и очищайте логи регулярно, чтобы не перегружать диск.

Сравнение подходов обновления статуса заказа