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

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

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

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

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

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

function user_has_cancelled_orders( $user_id ) {
    if ( ! $user_id ) {
        return false;
    }
    $args = [
        'customer_id' => $user_id,
        'status'      => 'cancelled',
        'limit'       => 1,
        'return'      => 'ids',
    ];
    $orders = wc_get_orders( $args );
    return ! empty( $orders );
}

2. Фильтрация доступных платежных методов

Используем фильтр woocommerce_available_payment_gateways для исключения методов при наличии отказанных заказов.

add_filter( 'woocommerce_available_payment_gateways', 'disable_payment_methods_for_cancelled_orders' );
function disable_payment_methods_for_cancelled_orders( $available_gateways ) {
    if ( is_admin() ) {
        return $available_gateways; // Не изменяем в админке
    }

    $user_id = get_current_user_id();
    if ( user_has_cancelled_orders( $user_id ) ) {
        // Перечислите ID платежных методов для отключения
        $disabled_methods = array( 'cod', 'bacs' ); // пример: оплата при доставке и банковский перевод

        foreach ( $disabled_methods as $method_id ) {
            if ( isset( $available_gateways[ $method_id ] ) ) {
                unset( $available_gateways[ $method_id ] );
            }
        }
    }
    return $available_gateways;
}

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

1. Авторизуйтесь под пользователем с заказом в статусе «отказан» и перейдите в корзину или оформление заказа.

2. Убедитесь, что указанные платежные методы (например, cod и bacs) отсутствуют в списке доступных.

3. Авторизуйтесь под пользователем без отказанных заказов — методы должны отображаться.

4. При необходимости очистите кэш сайта и браузера, если изменения не видны.

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

• Код не работает в админке: это ожидаемо, фильтр ограничен фронтендом через is_admin().
• Платежные методы не отключаются: убедитесь, что в массиве $disabled_methods правильные ID методов (узнать ID можно в WooCommerce → Настройки → Платежи или через отладку print_r($available_gateways)).
• Пользователь не авторизован: функция не сработает для гостей, для них нужно отдельная логика или не отключать методы.
• Статус заказа указан неверно: статус «отказан» в WooCommerce по умолчанию называется cancelled, проверьте правильность написания.

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

• Используйте wc_get_orders с ограничением limit=1 для минимизации нагрузки на базу.
• Не храните результаты проверки в сессиях без необходимости — это приведёт к рассинхронизации данных.
• Для сайтов с большим числом заказов можно добавить дополнительный индекс в базе по customer_id и status или использовать кеширование результата.
• Добавляйте проверку is_admin(), чтобы не влиять на работу админки и REST API.

Таблица сравнения вариантов реализации