WooCommerce: автоматический сброс статуса заказа при ошибках платежа

Проблема: заказ застревает в статусе обработки после ошибки платежа

В WooCommerce при возникновении ошибки оплаты (например, отказ платежного шлюза или отмена пользователем) заказы иногда остаются в статусе processing или on-hold, что создает путаницу и требует ручной проверки. Это приводит к неправильной статистике и возможным ошибкам в учете.

Почему это происходит

Некоторые платежные шлюзы создают заказ и меняют его статус на processing сразу после создания, до подтверждения успешной оплаты. Если оплата не проходит, статус не меняется автоматически, и заказ остается в системе как активный.

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

• Проверьте статус заказов в WooCommerce — есть ли много заказов со статусом processing, которые не были оплачены.
• Сравните логи платежного шлюза и WooCommerce — совпадают ли ошибки оплаты с заказами в статусе processing.
• Активируйте режим отладки WooCommerce: в wp-config.php добавьте define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); и проверьте /wp-content/debug.log.

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

Добавим в functions.php вашей темы код, который будет слушать события неудачной оплаты и сбрасывать статус заказа в failed.

add_action('woocommerce_order_status_on-hold_to_failed', 'reset_order_status_on_payment_error');
add_action('woocommerce_order_status_processing_to_failed', 'reset_order_status_on_payment_error');

function reset_order_status_on_payment_error($order) {
    // Проверяем, есть ли ошибка оплаты через мета
    $error = get_post_meta($order->get_id(), '_payment_error', true);
    if ($error) {
        $order->update_status('failed', 'Автоматический сброс статуса из-за ошибки платежа: ' . $error);
    }
}

Однако не все платежные шлюзы записывают ошибку в мета. Для универсального решения можно использовать хук woocommerce_payment_complete и состояние транзакции через API шлюза.

Пример универсального хука для проверки статуса платежа (Stripe пример)

add_action('woocommerce_checkout_order_processed', 'check_payment_status_and_reset', 20, 3);
function check_payment_status_and_reset($order_id, $posted_data, $order) {
    if ($order->get_payment_method() !== 'stripe') {
        return; // Только для Stripe
    }

    $payment_intent_id = get_post_meta($order_id, '_stripe_intent_id', true);
    if (!$payment_intent_id) {
        return;
    }

    // Предполагается, что есть доступ к Stripe API
    \Stripe\Stripe::setApiKey('ваш_секретный_ключ');
    $intent = \Stripe\PaymentIntent::retrieve($payment_intent_id);

    if ($intent->status === 'requires_payment_method' || $intent->status === 'canceled') {
        $order->update_status('failed', 'Оплата не прошла, статус платежа: ' . $intent->status);
    }
}

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

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

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

• Не срабатывает сброс статуса: возможно, платежный шлюз не передает информацию об ошибке. Проверьте, записываются ли метаданные в заказ и корректно ли настроены хуки.
• Конфликт с плагинами кеширования: отключите кеширование страниц для страниц оформления заказа и статистики WooCommerce.
• Отсутствие ключей API или неправильная настройка Stripe/PayPal: проверьте корректность ключей и прав доступа.
• Статус меняется неправильно для успешных заказов: убедитесь, что условие проверки статуса платежа не слишком общее и не срабатывает для успешных транзакций.

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

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

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