WooCommerce: автоматическое отключение оплаты при неподтверждённом заказе с помощью хуков

Диагностика проблемы: почему нужно отключать оплату для неподтверждённых заказов

В WooCommerce заказы могут быть созданы, но оставаться в статусе "ожидает оплаты" или "обработка" без подтверждения со стороны администратора или пользователя. В таких случаях платежи могут зависнуть, пользователи не получить уведомления, а склад — быть неактуальным. Автоматическое отключение возможности оплаты для неподтверждённых заказов помогает избежать ошибок, переплат и потери контроля над заказами.

Пошаговое решение: отключаем оплату для неподтверждённых заказов

1. Определяем неподтверждённые заказы

Для начала нужно четко понимать, какие статусы считаются неподтверждёнными. Обычно это pending (ожидает оплаты) и on-hold (в ожидании). Можно расширить список под свои задачи.

2. Используем хук woocommerce_available_payment_gateways

Этот хук позволяет фильтровать доступные платежные шлюзы на странице оформления заказа. Если заказ неподтверждён, мы будем возвращать пустой массив, чтобы блокировать оплату.

add_filter('woocommerce_available_payment_gateways', 'disable_payment_for_unconfirmed_orders');
function disable_payment_for_unconfirmed_orders($available_gateways) {
    if (is_admin()) return $available_gateways; // Не трогаем админку

    if (WC()->cart->is_empty()) return $available_gateways; // Нет товаров - не меняем

    $order_id = isset($_GET['order_id']) ? intval($_GET['order_id']) : 0;
    if (!$order_id) return $available_gateways; // Нет ID заказа

    $order = wc_get_order($order_id);
    if (!$order) return $available_gateways; // Не найден заказ

    $unconfirmed_statuses = array('pending', 'on-hold');
    if (in_array($order->get_status(), $unconfirmed_statuses)) {
        // Отключаем все платежные методы
        return array();
    }
    return $available_gateways;
}

3. Блокируем оплату на странице "Мой аккаунт"

Для заказов в списке "Мой аккаунт" можно скрыть кнопку оплаты, если статус неподтверждён.

add_filter('woocommerce_my_account_my_orders_actions', 'remove_pay_action_for_unconfirmed_orders', 10, 2);
function remove_pay_action_for_unconfirmed_orders($actions, $order) {
    $unconfirmed_statuses = array('pending', 'on-hold');
    if (in_array($order->get_status(), $unconfirmed_statuses)) {
        unset($actions['pay']);
    }
    return $actions;
}

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

• Создайте заказ с статусом pending или on-hold.
• Перейдите на страницу оформления заказа или в "Мой аккаунт" — кнопка оплаты должна отсутствовать.
• Попробуйте сменить статус заказа на processing или completed — кнопка оплаты должна появиться.

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

• Платежи не отключаются: проверьте, передаётся ли корректно ID заказа через параметр order_id. Если используется кастомная логика, адаптируйте получение заказа.
• Отключается оплата для всех заказов: убедитесь, что фильтр проверяет статус заказа, а не просто возвращает пустой массив.
• Конфликты с кешированием: кеширование страниц может сохранять старый вид кнопок оплаты. Отключите кеш для страниц оформления заказа и "Мой аккаунт".

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

• Фильтр woocommerce_available_payment_gateways вызывается часто, избегайте тяжелых запросов внутри функции.
• Проверяйте наличие заказа перед обработкой, чтобы избежать ошибок PHP.
• Для более точной логики используйте nonce и проверку прав пользователя, если заказ передается через URL.
• Рекомендуется использовать WP-CLI для массовой проверки и обновления статусов заказов при необходимости.

Сравнение способов отключения оплаты для неподтверждённых заказов

Чек-лист для внедрения автоматического отключения оплаты

• Определить, какие статусы считаются неподтверждёнными
• Добавить фильтр woocommerce_available_payment_gateways с проверкой статуса заказа
• Удалить кнопку оплаты для неподтверждённых заказов в "Мой аккаунт"
• Проверить корректность работы на тестовых заказах
• Отключить кеширование страниц оплаты и аккаунта
• Проверить совместимость с установленными плагинами платежей
• Рассмотреть уведомления для пользователей о статусе заказа