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

Диагностика проблемы с платежами в WooCommerce

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

Как понять, что статус заказа не соответствует реальному состоянию платежа?

• Заказы долго остаются в статусе pending или on-hold без подтверждения оплаты.
• Платёжные шлюзы возвращают ошибки или отказы, но WooCommerce не обновляет статус.
• Отсутствуют уведомления администратора о проблемах с платежами.

Пошаговое решение: автоматическое изменение статуса заказа на "Отменён" или "Требует проверки"

Для реализации решения используем хук woocommerce_order_status_pending и проверяем статус платежа через API платёжной системы или по метаданным заказа.

function custom_change_order_status_on_payment_issue( $order_id ) {
    if ( ! $order_id ) {
        return;
    }

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

    // Пример проверки мета-поля с ошибкой платежа
    $payment_error = $order->get_meta( '_payment_error' );

    if ( $payment_error ) {
        // Меняем статус заказа на отменён
        $order->update_status( 'cancelled', 'Автоматическое изменение: проблема с платежом обнаружена.' );
    }
}
add_action( 'woocommerce_order_status_pending', 'custom_change_order_status_on_payment_issue', 10, 1 );

Если вы используете конкретный платёжный шлюз, можно интегрироваться с его API, например, через вебхуки, чтобы ставить мета-поле _payment_error при ошибках.

Альтернативный способ — периодическая проверка неоплаченных заказов

Добавляем функцию, которая запускается через WP-Cron и проверяет заказы в статусе pending или on-hold, меняя их статус при длительном отсутствии оплаты.

function custom_cron_check_pending_orders() {
    $args = array(
        'limit' => -1,
        'status' => array('pending', 'on-hold'),
        'date_created' => '<' . ( time() - DAY_IN_SECONDS * 3 ), // старше 3 дней
    );

    $orders = wc_get_orders( $args );
    foreach ( $orders as $order ) {
        // Дополнительные проверки платежа можно добавить здесь
        $order->update_status( 'cancelled', 'Автоматическое отмена заказа: отсутствие оплаты более 3 дней.' );
    }
}
add_action( 'custom_daily_order_check', 'custom_cron_check_pending_orders' );

// Регистрируем ежедневное событие WP-Cron
if ( ! wp_next_scheduled( 'custom_daily_order_check' ) ) {
    wp_schedule_event( time(), 'daily', 'custom_daily_order_check' );
}

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

• Создайте тестовый заказ с оплатой, которая будет отклонена (например, тестовый режим платёжного шлюза).
• Убедитесь, что при возникновении ошибки в метаданных заказа статус меняется на "Отменён".
• Запустите вручную событие WP-Cron или дождитесь запуска для проверки отложенной отмены старых неоплаченных заказов.
• Проверьте логи WooCommerce и письма администратора — должно появиться уведомление об изменении статуса.

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

• Не срабатывает изменение статуса: Проверьте, что хук подключён правильно, и функция вызывается. Добавьте error_log или дебаг в функции для проверки вызова.
• Отмена заказов происходит слишком рано: Подкорректируйте время в условии (например, менять статус только после 3 или 5 дней).
• Платёжный шлюз не сохраняет ошибку: Убедитесь, что интеграция с API платёжной системы корректно ставит мета-поля с ошибками.
• WP-Cron не запускается: Проверьте, работает ли WP-Cron на сервере, запустите вручную через wp cron event run --due-now или настройте системный cron.

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

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

Сравнение вариантов решения