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

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

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

Как реализовать автоматическое отключение платёжного метода

Обзор подхода

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

Шаг 1. Отслеживаем неудачные платежи с помощью хука woocommerce_payment_complete и woocommerce_order_status_failed

Метод woocommerce_order_status_failed срабатывает при переходе заказа в статус "failed". Здесь мы будем сохранять метку блокировки.

add_action('woocommerce_order_status_failed', 'block_payment_method_after_failed_order', 10, 1);
function block_payment_method_after_failed_order($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;
    $user_id = $order->get_user_id();
    if (!$user_id) return; // Только для зарегистрированных пользователей

    $payment_method = $order->get_payment_method();
    if (!$payment_method) return;

    // Сохраняем временную блокировку на 30 минут
    $block_until = time() + 30 * 60;
    update_user_meta($user_id, 'blocked_payment_method_' . $payment_method, $block_until);
}

Шаг 2. Исключаем заблокированные способы оплаты при выводе

С помощью фильтра woocommerce_available_payment_gateways можно убрать нужные методы из списка доступных.

add_filter('woocommerce_available_payment_gateways', 'filter_blocked_payment_methods');
function filter_blocked_payment_methods($available_gateways) {
    if (!is_user_logged_in()) {
        return $available_gateways; // Блокировка только для авторизованных
    }
    $user_id = get_current_user_id();

    foreach ($available_gateways as $gateway_id => $gateway) {
        $block_until = get_user_meta($user_id, 'blocked_payment_method_' . $gateway_id, true);
        if ($block_until && $block_until > time()) {
            unset($available_gateways[$gateway_id]);
        } elseif ($block_until && $block_until <= time()) {
            // Время блокировки прошло, удаляем мета
            delete_user_meta($user_id, 'blocked_payment_method_' . $gateway_id);
        }
    }
    return $available_gateways;
}

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

1. Создайте тестовый заказ с платёжным методом, который хотите блокировать.
2. Принудительно измените статус заказа на "Failed" в админке WooCommerce.
3. Авторизуйтесь под тем же пользователем и перейдите на страницу оформления заказа — заблокированный метод оплаты должен отсутствовать.
4. Подождите 30 минут (или измените время блокировки в коде на несколько секунд для теста) и обновите страницу — метод должен появиться снова.

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

• Метод не блокируется для гостей: блокировка реализована только для зарегистрированных пользователей, так как для гостей нет user_id. Для гостей можно рассмотреть блокировку по сессии или cookie, но это менее надёжно.
• Метод не появляется после истечения времени: убедитесь, что в коде правильно удаляется мета-ключ delete_user_meta и время сравнивается с текущим time().
• Ошибки с кешированием: если сайт использует кеширование страниц, убедитесь, что страница оформления заказа не кэшируется или реализуйте исключения для пользователей.

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

• Сохраняйте минимальный срок блокировки — 30 минут достаточно, чтобы предотвратить повторные попытки моментально, но не блокировать навсегда.
• Используйте update_user_meta и get_user_meta только для зарегистрированных пользователей, чтобы не создавать нагрузку на сессии и куки.
• Для улучшения UX можно добавить уведомление на странице оформления заказа, если определённые методы временно недоступны.
• Проверьте совместимость с плагинами кеширования и при необходимости добавьте исключения для страницы оформления заказа (checkout).

Сравнение вариантов реализации блокировки платёжных методов