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

Диагностика проблемы с неподтверждёнными заказами и оплатой

В WooCommerce часто возникает ситуация, когда покупатель создаёт заказ, но не завершает оплату, или заказ остаётся в статусе «в ожидании оплаты» длительное время. Это может привести к путанице с методами оплаты: некоторые способы остаются активными, хотя их нужно временно отключить для таких заказов, чтобы предотвратить повторные попытки оплаты или ошибки. В первую очередь нужно убедиться, что проблема именно в статусе заказа и способах оплаты.

Как проверить наличие проблемы

• Перейдите в WooCommerce → Заказы и проверьте количество заказов со статусом on-hold или pending.
• Попробуйте сделать тестовый заказ, не завершая оплату, и посмотрите, доступны ли все способы оплаты.
• Проверьте, не допускает ли ваш текущий конфиг повторных оплат на неполные заказы.

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

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

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

function has_pending_order_for_user( $user_id ) {
    if ( ! $user_id ) {
        return false;
    }
    $args = array(
        'customer_id' => $user_id,
        'status'      => array( 'pending', 'on-hold' ),
        'limit'       => 1,
    );
    $orders = wc_get_orders( $args );
    return ! empty( $orders );
}

2. Фильтруем доступные способы оплаты

add_filter( 'woocommerce_available_payment_gateways', 'disable_payment_gateways_for_pending_orders' );
function disable_payment_gateways_for_pending_orders( $available_gateways ) {
    if ( ! is_user_logged_in() ) {
        return $available_gateways; // Не применяем для гостей
    }
    $user_id = get_current_user_id();
    if ( has_pending_order_for_user( $user_id ) ) {
        // Список способов оплаты, которые нужно отключить
        $disabled_gateways = array( 'cod', 'cheque' ); // пример: оплата при получении и чек
        foreach ( $disabled_gateways as $gateway_id ) {
            if ( isset( $available_gateways[ $gateway_id ] ) ) {
                unset( $available_gateways[ $gateway_id ] );
            }
        }
    }
    return $available_gateways;
}

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

• Залогиньтесь под пользователем с неподтверждённым заказом.
• Перейдите в корзину и оформите заказ.
• Убедитесь, что указанные способы оплаты (например, cod и cheque) отсутствуют в списке доступных.
• Для пользователя без неподтверждённых заказов все способы оплаты должны отображаться.

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

• Функция wc_get_orders возвращает пустой массив: проверьте, что у пользователя действительно есть заказы с нужным статусом и что customer_id передаётся корректно. Для гостей механизм не работает, нужна отдельная логика по IP или сессиям.
• Способы оплаты не отключаются: убедитесь, что ID способов оплаты указаны правильно. Их можно посмотреть в WooCommerce → Настройки → Способы оплаты или в коде плагинов.
• Фильтр woocommerce_available_payment_gateways не срабатывает: проверьте, что код добавлен в functions.php активной темы или в плагин, и что нет конфликтов с другими плагинами, которые могут менять способы оплаты.
• Пользователь не залогинен: данный код не применим к гостям, если нужны гостевые проверки, нужно расширять логику.

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

• Используйте кэширование результатов функции has_pending_order_for_user, чтобы не делать запрос к базе на каждый вызов фильтра (например, transient API с небольшим сроком).
• Не отключайте все способы оплаты, чтобы не заблокировать пользователя окончательно — лучше отключать только проблемные методы.
• Проверяйте статус заказов регулярно, чтобы случайно не блокировать пользователей с завершёнными заказами.
• Всегда тестируйте на тестовой среде, чтобы избежать сбоев в реальном магазине.

Сравнение подходов: плагин vs код vs компромисс