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

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

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

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

• Заказы с отключенным методом оплаты остаются в статусе «on-hold» или «pending» долгое время без обновления.
• Отсутствие уведомлений или автоматического изменения статуса в админке WooCommerce.
• Клиенты не получают обратной связи по статусу заказа после отключения метода оплаты.

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

1. Определяем отключенный метод оплаты

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

2. Создаем функцию для изменения статуса заказа

Добавим следующий код в functions.php дочерней темы или в кастомный плагин:

add_action('woocommerce_order_status_pending', 'auto_change_status_if_payment_disabled');
add_action('woocommerce_order_status_on-hold', 'auto_change_status_if_payment_disabled');

function auto_change_status_if_payment_disabled($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if (!$order) return;

    $payment_method = $order->get_payment_method();
    
    // Получаем активные методы оплаты
    $available_gateways = WC()->payment_gateways()->get_available_payment_gateways();

    // Если метод оплаты заказа отсутствует среди активных, меняем статус
    if (!isset($available_gateways[$payment_method])) {
        // Пример смены статуса на 'cancelled'
        $order->update_status('cancelled', 'Статус изменен автоматически: метод оплаты отключен.');
    }
}

Этот код слушает переход заказа в статусы pending и on-hold, проверяет, активен ли метод оплаты, и если нет — изменяет статус на cancelled.

3. Оптимизация для массовой проверки

Если на сайте уже есть много заказов с отключённым методом оплаты, имеет смысл запустить массовую проверку через WP-CLI или отдельный скрипт:

function wc_bulk_check_disabled_payment_orders() {
    $args = array(
        'limit' => -1,
        'status' => array('pending', 'on-hold'),
    );
    $orders = wc_get_orders($args);
    $available_gateways = WC()->payment_gateways()->get_available_payment_gateways();

    foreach ($orders as $order) {
        $payment_method = $order->get_payment_method();
        if (!isset($available_gateways[$payment_method])) {
            $order->update_status('cancelled', 'Автоматическая отмена: метод оплаты отключен.');
        }
    }
}
// Вызывать функцию вручную или по расписанию через WP-Cron

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

• Создайте тестовый заказ с методом оплаты, который затем отключите в настройках WooCommerce.
• Переведите заказ в статус pending или on-hold (например, вручную или при оформлении).
• Обновите страницу админки заказов и проверьте, что статус изменился на cancelled.
• Проверьте, что в комментариях заказа появилась запись с причиной смены статуса.

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

• Не срабатывает изменение статуса: Убедитесь, что хук woocommerce_order_status_pending и woocommerce_order_status_on-hold корректно подключены. Проверьте, что код добавлен в активную тему или плагин.
• Метод оплаты не определяется: Используйте метод $order->get_payment_method() — он возвращает ID метода оплаты, который должен совпадать с ключом в WC()->payment_gateways()->get_available_payment_gateways().
• Статус не меняется на нужный: Проверьте, что используемый статус поддерживается WooCommerce. Например, cancelled или failed — стандартные статусы, которые можно применить.
• Конфликт с другими плагинами: Отключите временно сторонние плагины, чтобы проверить, нет ли конфликтов с обработкой статусов.

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

• Не осуществляйте массовую обработку заказов на каждой загрузке страницы — используйте WP-Cron с интервалом, например, раз в сутки.
• Для больших магазинов с тысячами заказов реализуйте обработку пакетами, чтобы не перегружать сервер.
• Логируйте изменения статусов заказов, чтобы отслеживать автоматические действия и иметь историю для поддержки.
• Не меняйте статус заказов без уведомления пользователей через email — добавьте в письмо пояснение о причине отмены заказа.

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