WooCommerce: Автоматическое отключение платежей при неуспешной оплате

В чем суть проблемы с неуспешными платежами в WooCommerce

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

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

Диагностика проблемы: как понять, что платеж неуспешен и платежи не отключаются

Для диагностики используйте следующие шаги:

• Проверьте статус заказов в WooCommerce (в админке › Заказы). Статус «Ожидает оплаты» означает, что платеж не завершен.
• Ознакомьтесь с логами платежного шлюза (обычно доступны в WooCommerce › Статус › Логи) — там видно, принята ли оплата.
• Если платеж не прошел, но покупатель может попытаться оплатить повторно через тот же способ, значит, нет автоматической блокировки.

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

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

1. Добавляем проверку статуса заказа и блокируем метод оплаты

Основная идея — в момент загрузки страниц оплаты проверить, есть ли у пользователя неуспешные заказы, и если да — скрыть метод оплаты.

Пример кода для functions.php вашей темы или собственного плагина:

add_filter('woocommerce_available_payment_gateways', 'disable_payment_for_failed_orders');
function disable_payment_for_failed_orders($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; // если гость, ничего не делаем

    $args = array(
        'customer_id' => $user_id,
        'status' => array('failed', 'pending'), // статусы с проблемами
        'limit' => 1
    );

    $orders = wc_get_orders($args);
    if (count($orders) > 0) {
        // Отключаем все методы оплаты
        $available_gateways = array();
    }
    return $available_gateways;
}

2. Уведомление администратора и покупателя

Полезно уведомить администратора о наличии неуспешных попыток оплаты:

add_action('woocommerce_order_status_failed', 'notify_admin_on_failed_payment', 10, 1);
function notify_admin_on_failed_payment($order_id) {
    $order = wc_get_order($order_id);
    $to = get_option('admin_email');
    $subject = 'Неуспешный платеж: заказ #' . $order_id;
    $message = 'Платеж по заказу #' . $order_id . ' не прошел.';
    wp_mail($to, $subject, $message);
}

Для уведомления покупателя можно использовать стандартные уведомления WooCommerce или добавить кастомный e-mail через хуки.

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

• Создайте тестовый заказ с неуспешной оплатой (можно использовать тестовый режим платежного шлюза).
• Перейдите на страницу оформления заказа под аккаунтом покупателя с таким заказом.
• Убедитесь, что методы оплаты отсутствуют или недоступны.
• Проверьте почту администратора — должно прийти уведомление о неуспешном платеже.

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

• Методы оплаты не отключаются для гостей. Код учитывает только авторизованных пользователей, для гостей нужно реализовать отдельную логику по IP или сессии.
• Отключаются все платежи, а нужно только конкретный метод. В таком случае фильтр woocommerce_available_payment_gateways можно изменить так, чтобы удалять только нужные ключи из массива.
• Проблемы с производительностью из-за частых вызовов wc_get_orders. Добавьте кэширование результатов на пару минут, чтобы снизить нагрузку.

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

• Безопасность: не храните информацию о неуспешных платежах в куках или сессиях без шифрования, используйте безопасные методы идентификации пользователя.
• Производительность: кешируйте результаты запросов к заказам с помощью Transients API, например:

function has_failed_orders($user_id) {
    $cache_key = 'failed_orders_' . $user_id;
    $has_failed_orders = get_transient($cache_key);
    if ($has_failed_orders === false) {
        $orders = wc_get_orders(array(
            'customer_id' => $user_id,
            'status' => array('failed', 'pending'),
            'limit' => 1
        ));
        $has_failed_orders = (count($orders) > 0);
        set_transient($cache_key, $has_failed_orders, 5 * MINUTE_IN_SECONDS);
    }
    return $has_failed_orders;
}

Вызовите эту функцию внутри фильтра вместо прямого запроса.

Сравнение подходов к блокировке платежей