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

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

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

Основные признаки проблемы:

• Заказы остаются в статусе «В обработке» или «Ожидает оплаты» слишком долго;
• Нет автоматического перехода в статус «Отменён» или «Ошибка оплаты» при неудачных платежах;
• Отсутствие уведомлений для администраторов о проблемах с оплатой.

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

1. Определение критериев проблемного заказа

Выбираем статусы, при которых необходимо автоматически изменить статус заказа. Например, если заказ длительное время находится в статусе pending (ожидает оплаты) или failed (ошибка оплаты).

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

Добавим в файл functions.php вашей темы или в кастомный плагин следующий код, который будет менять статус заказов, которые не были оплачены в течение 24 часов, на статус cancelled:

function wpkpi_auto_cancel_unpaid_orders() {
    $args = array(
        'limit'        => -1,
        'status'       => array('pending', 'failed'),
        'date_created' => '<' . ( time() - DAY_IN_SECONDS ),
    );

    $orders = wc_get_orders( $args );

    foreach ( $orders as $order ) {
        $order->update_status( 'cancelled', 'Автоматическая отмена заказа из-за отсутствия оплаты более 24 часов' );
    }
}
add_action( 'woocommerce_scheduled_sales', 'wpkpi_auto_cancel_unpaid_orders' );

Объяснение: функция ищет все заказы в статусах pending и failed, созданные более 24 часов назад, и меняет их статус на cancelled.

3. Планирование регулярного запуска функции

Чтобы функция автоматически запускалась, необходимо использовать WP-Cron. Если хук woocommerce_scheduled_sales не подходит, можно создать собственный крон-задачу:

function wpkpi_register_cron_event() {
    if ( ! wp_next_scheduled( 'wpkpi_cancel_unpaid_orders_event' ) ) {
        wp_schedule_event( time(), 'hourly', 'wpkpi_cancel_unpaid_orders_event' );
    }
}
add_action( 'wp', 'wpkpi_register_cron_event' );

add_action( 'wpkpi_cancel_unpaid_orders_event', 'wpkpi_auto_cancel_unpaid_orders' );

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

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

• Создайте тестовый заказ и оставьте его неоплаченным более 24 часов (можно вручную изменить дату создания заказа через базу данных для теста);
• Запустите wp-cron вручную (например, через плагин WP Crontrol или curl-запрос к wp-cron.php);
• Проверьте, что статус заказа изменился на cancelled и в журнале заказов появилась запись с комментарием об автоматической отмене.

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

• Функция не запускается автоматически. Причина: отключен WP-Cron или неправильно зарегистрирован хук. Проверьте, активен ли WP-Cron и правильно ли добавлен хук add_action.
• Заказы не выбираются для отмены. Причина: неверный фильтр даты в wc_get_orders. Убедитесь, что параметр date_created использован правильно и соответствует формату.
• Статус не меняется, возникает ошибка прав. Проверьте, что функция вызывается с правами администратора и что WordPress может изменять статусы заказов.

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

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

Сравнение способов реализации автоматического изменения статуса