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

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

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

Как отследить неудачные оплаты в WooCommerce

WooCommerce фиксирует статус заказа в wc_order_statuses. Неудачные оплаты обычно переводят заказ в статус failed или cancelled. Для автоматизации нам нужно отследить смену статуса заказа на один из этих и отключить способ оплаты для пользователя (например, на время или навсегда).

Основные хуки для отслеживания статуса заказа

• woocommerce_order_status_failed — срабатывает при переводе заказа в статус failed.
• woocommerce_order_status_cancelled — срабатывает при отмене заказа.

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

Реализуем логику отключения способа оплаты для конкретного пользователя, который совершил неудачную попытку оплаты. Для примера отключим метод «Оплата при получении» (cod) на 24 часа после неудачной оплаты.

Шаг 1. Запоминаем пользователя и время неудачной оплаты

add_action('woocommerce_order_status_failed', 'wpaddons_handle_failed_payment', 10, 1);
function wpaddons_handle_failed_payment($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    $user_id = $order->get_user_id();
    if (!$user_id) return; // только для авторизованных

    // Сохраняем мета пользователя с временем блокировки
    update_user_meta($user_id, '_payment_failed_cod_block', time());
}

Шаг 2. Фильтруем доступные способы оплаты в корзине и оформлении заказа

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

    if (!is_checkout()) return $available_gateways; // только на оформлении заказа

    $user_id = get_current_user_id();
    if (!$user_id) return $available_gateways;

    $block_time = get_user_meta($user_id, '_payment_failed_cod_block', true);
    if ($block_time) {
        $block_duration = 24 * 3600; // 24 часа
        if ((time() - $block_time) < $block_duration) {
            // Отключаем cod
            if (isset($available_gateways['cod'])) {
                unset($available_gateways['cod']);
            }
        } else {
            // Снимаем блокировку
            delete_user_meta($user_id, '_payment_failed_cod_block');
        }
    }

    return $available_gateways;
}

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

• Создайте заказ с оплатой «Оплата при получении» и переведите его в статус failed (можно вручную в админке).
• Залогиньтесь под тем же пользователем и перейдите на страницу оформления заказа.
• Способ оплаты «Оплата при получении» должен быть отключён (не отображаться).
• Через 24 часа (или измените переменную $block_duration для теста на меньшее время) способ оплаты появится снова.

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

• Не работает для гостей: В коде используется get_current_user_id(), поэтому гости не блокируются. Для гостей можно использовать cookie или сессии, но это менее надёжно.
• Способ оплаты не отключается: Проверьте, правильно ли указан ID способа оплаты (например, cod для «Оплата при получении»). Посмотреть ID можно в WooCommerce > Настройки > Способы оплаты или в коде плагина.
• Блокировка не снимается: Убедитесь, что время блокировки сравнивается с текущим временем правильно. Для отладки добавьте временные логи.
• Кэширование страниц: Если на сайте стоит кэширование, оно может мешать обновлению способов оплаты. Используйте AJAX для обновления или отключите кэш на странице оформления заказа.

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

• Для блокировки используйте мета пользователей, а не опции сайта — это масштабируемо и безопасно.
• Минимизируйте количество обращений к базе — кэшируйте данные, если возможно.
• Не блокируйте способы оплаты навсегда, лучше ставьте разумные сроки.
• Проверяйте совместимость с плагинами кэширования и оптимизации, например, Clearfy Pro (https://wpshop.ru/plugins/clearfy?utm_source=wpaddons.ru&utm_medium=article&utm_campaign=woocommerce-automaticheskoe-otkljuchenie-sposobov-oplaty-pri-neudachnoj-oplate) для управления кэшом.
• При необходимости расширяйте логику для других способов оплаты, учитывая их ID и условия.

Сравнение вариантов реализации