WooCommerce: как реализовать отмену и возврат заказов с собственной логикой

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

По умолчанию WooCommerce не предоставляет продвинутых инструментов для отмены и возврата заказов с кастомными условиями. Часто пользователи сталкиваются с такими проблемами:

• Отсутствие механизма для автоматической отмены заказов при определённых условиях (например, просроченный платеж).
• Невозможность программно изменить статус заказа с возвратом средств и уведомлением клиента.
• Сложность интеграции логики возврата с внешними системами (CRM, склад).

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

Пошаговое решение: как добавить кастомную отмену и возврат заказа в WooCommerce

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

Для начала реализуем функцию, которая отменяет заказ с возвратом платежа:

function custom_cancel_and_refund_order($order_id) {
    if (!class_exists('WC_Order')) return false;
    $order = wc_get_order($order_id);
    if (!$order) return false;

    // Проверяем, можно ли вернуть деньги
    if (!$order->has_status(array('processing', 'completed'))) {
        return false; // возврат возможен только для обработанных или выполненных заказов
    }

    // Создаем возврат
    $refund = wc_create_refund(array(
        'amount'     => $order->get_total(),
        'reason'     => 'Отмена заказа по пользовательской логике',
        'order_id'   => $order_id,
        'refund_payment' => true,
    ));

    if (is_wp_error($refund)) {
        return false;
    }

    // Меняем статус заказа на отменён
    $order->update_status('cancelled', 'Заказ отменён и оплата возвращена.');
    return true;
}

2. Запуск отмены по условию (например, при просроченном платеже)

Добавим хук, который проверяет заказы с определённой задержкой и отменяет их:

add_action('wp', 'custom_check_and_cancel_orders');
function custom_check_and_cancel_orders() {
    if ( !is_admin() ) return;

    $args = array(
        'limit' => -1,
        'status' => 'pending',
        'date_created' => '<' . (time() - 3600 * 24) // заказы старше 24 часов
    );
    $orders = wc_get_orders($args);

    foreach ($orders as $order) {
        // Отмена заказа
        custom_cancel_and_refund_order($order->get_id());
    }
}

Как проверить, что решение работает

• Создайте тестовый заказ с оплатой в статусе pending.
• Измените дату создания заказа в базе на более чем 24 часа назад (через phpMyAdmin или WP-CLI).
• Обновите любую страницу в админке — сработает проверка и заказ должен быть отменён с возвратом.
• Проверьте статус заказа и журнал действий в WooCommerce.
• Проверьте возврат на платёжном шлюзе (если интеграция поддерживается).

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

• Ошибка возврата: "Refund amount exceeds order amount". Проверьте, что сумма возврата не превышает сумму заказа и что возврат не был сделан ранее.
• Заказ не меняет статус на отменён. Убедитесь, что статус cancelled зарегистрирован, а хук срабатывает в нужном месте.
• Возврат не проходит на платёжном шлюзе. Проверьте настройки интеграции платежного плагина, поддерживает ли он автоматический возврат через API.
• Функция не вызывается в админке. Возможно, условие is_admin() блокирует вызов; настраивайте запуск в WP-Cron или через WP-CLI для автоматизации.

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

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

Сравнение вариантов реализации отмены и возврата заказов WooCommerce