WooCommerce: отключение автоматического изменения статуса заказа после оплаты

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

В стандартной конфигурации WooCommerce после успешной оплаты заказ автоматически переводится в статус processing или completed в зависимости от типа товара. Иногда возникает необходимость отключить это поведение и контролировать смену статуса вручную, например, для дополнительной проверки платежа или интеграций с внешними сервисами.

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

Чтобы понять, что именно происходит с заказом после оплаты, используйте логирование статусов и хуков WooCommerce:

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"); }

После оплаты проверьте error_log — если заказ меняет статус на processing или completed без вашего вмешательства, значит автоматическое обновление активно.

Пошаговое решение отключения автоматического изменения статуса

1. Отключаем стандартный обработчик смены статуса после оплаты

WooCommerce использует хуки, чтобы автоматически менять статус заказа после успешного платежа. Чтобы отменить это, нужно снять соответствующие обработчики.

// Отключаем автоматическое обновление статуса после оплаты add_action('init', function() { remove_action('woocommerce_thankyou', 'woocommerce_payment_complete_order_status'); remove_action('woocommerce_order_status_pending_to_processing', 'woocommerce_payment_complete_order_status'); remove_action('woocommerce_order_status_pending_to_completed', 'woocommerce_payment_complete_order_status'); remove_action('woocommerce_order_status_failed_to_processing', 'woocommerce_payment_complete_order_status'); remove_action('woocommerce_order_status_failed_to_completed', 'woocommerce_payment_complete_order_status'); });

2. Создаем собственный механизм смены статуса

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

add_action('your_custom_payment_confirmation_hook', function($order_id) { $order = wc_get_order($order_id); if(!$order) return; // Проверяем условия оплаты $order->update_status('processing', 'Статус обновлен вручную после проверки платежа'); });

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

• Оплатите заказ тестово через платежный шлюз.
• Убедитесь, что статус заказа после оплаты не меняется автоматически на processing или completed.
• Проверьте логи, чтобы убедиться, что ваш собственный обработчик не срабатывает без необходимости.
• При ручном вызове смены статуса статус заказа должен измениться.

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

• Не отключен нужный хук: Проверьте, что remove_action вызывается после того, как WooCommerce добавляет свои обработчики (обычно через init с приоритетом 10 или выше).
• Кэширование: Если вы используете плагин кэширования или объектный кэш, статус может не обновляться мгновенно. Очистите кэш.
• Платежный шлюз переопределяет статус: Некоторые шлюзы используют собственные хуки для смены статуса. В этом случае нужно искать и отключать их обработчики отдельно.
• Неправильный ID заказа в кастомном обработчике: Убедитесь, что $order_id передается корректно и объект заказа создается через wc_get_order().

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

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

Сравнение вариантов отключения автоматической смены статуса