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

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

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

Как понять, что проблема есть?

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

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

Реализуем автоматическое отключение способов оплаты на уровне мета-данных заказа и видимости способов оплаты в корзине и на странице оформления заказа.

1. Добавляем мета-данные с отключёнными способами оплаты для отменённых заказов

add_action('woocommerce_order_status_cancelled', 'disable_payment_methods_on_cancelled_order');
function disable_payment_methods_on_cancelled_order($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Сохраняем используемый способ оплаты в мета заказа для последующего отключения
    $payment_method = $order->get_payment_method();
    if ($payment_method) {
        update_post_meta($order_id, '_disabled_payment_method', $payment_method);
    }
}

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

add_filter('woocommerce_available_payment_gateways', 'filter_payment_gateways_for_cancelled_orders');
function filter_payment_gateways_for_cancelled_orders($available_gateways) {
    if (!is_checkout() && !is_cart()) {
        return $available_gateways;
    }

    // Получаем ID заказа из запроса (если есть)
    $order_id = isset($_GET['order_id']) ? absint($_GET['order_id']) : 0;
    if (!$order_id) {
        return $available_gateways;
    }

    $disabled_payment = get_post_meta($order_id, '_disabled_payment_method', true);
    if ($disabled_payment && isset($available_gateways[$disabled_payment])) {
        unset($available_gateways[$disabled_payment]);
    }

    return $available_gateways;
}

3. Обработка случаев повторного оформления заказа с тем же способом оплаты

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

add_action('woocommerce_checkout_process', 'check_disabled_payment_method_on_checkout');
function check_disabled_payment_method_on_checkout() {
    if (isset($_GET['order_id'])) {
        $order_id = absint($_GET['order_id']);
        $disabled_payment = get_post_meta($order_id, '_disabled_payment_method', true);
        if ($disabled_payment && isset(WC()->session) && WC()->session->get('chosen_payment_method') === $disabled_payment) {
            wc_add_notice('Выбранный способ оплаты недоступен для этого заказа, так как он был отменён.', 'error');
        }
    }
}

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

• Создайте заказ и выберите способ оплаты.
• Отмените заказ через админку WooCommerce.
• Попробуйте повторно оформить заказ или оплатить отменённый заказ, передав параметр ?order_id=ID_заказа в URL.
• Убедитесь, что способ оплаты, использованный в отменённом заказе, больше не отображается в списке доступных для данного заказа.
• Проверьте, что при попытке выбрать отключённый способ оплаты выводится ошибка.

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

• Метод оплаты не отключается: Проверьте, что хук woocommerce_order_status_cancelled срабатывает, а функция update_post_meta записывает мета-данные. Для отладки используйте error_log() или плагины для отладки.
• Способ оплаты отключается для всех заказов: Убедитесь, что фильтр woocommerce_available_payment_gateways корректно получает order_id, не применяется глобально.
• Ошибка при повторной оплате: Проверьте, что сессия WooCommerce корректно получает выбранный метод оплаты и он сравнивается с отключённым методом.

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

• Не храните чувствительные данные в мета-данных заказа, только идентификаторы способов оплаты.
• Минимизируйте количество запросов к базе данных, кешируя результаты, если планируется массовая обработка заказов.
• Тестируйте изменения на тестовом сайте с включённым режимом отладки WooCommerce и WordPress.
• Для комплексных кейсов с большим количеством способов оплаты и сложной логикой рассмотрите использование специализированных плагинов с поддержкой бизнес-правил оплаты.

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

Метод	Плюсы	Минусы	Пример
Код в functions.php	Лёгкая настройка, не требует плагинов	Требует навыков, ограничена расширяемость	Пример из статьи
Плагин отключения оплаты	Простой интерфейс, поддержка обновлений	Может быть избыточным, нагрузка	Clearfy
Кастомный плагин	Максимальный контроль, расширяемость	Требует времени и поддержки	Реализация на базе примера