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

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

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

Типичные проявления проблемы:

• Заказ остаётся со статусом processing или completed, хотя клиенту нужно отменить покупку.
• Отмена через админку неудобна при массовых ошибках.
• Платёж проведён, но товар не отправлен, и нужен возврат.

Как программно отменить заказ после оплаты

Использование стандартных функций WooCommerce для изменения статуса заказа

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

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

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

    // Проверяем, что заказ оплачен
    if ($order->is_paid()) {
        // Меняем статус на отменён
        $order->update_status('cancelled', 'Заказ отменён программно после оплаты.');

        // Запускаем возврат платежа, если поддерживается
        if (method_exists($order, 'refund')) {
            // Пример возврата полной суммы
            $refund = wc_create_refund(array(
                'amount'     => $order->get_total(),
                'reason'     => 'Автоматическая отмена заказа',
                'order_id'   => $order_id,
                'refund_payment' => true,
            ));
        }
    }
}

// Пример вызова функции при необходимости
// wp7_cancel_order_after_payment(1234);

Автоматизация отмены по событию

Для автоматического срабатывания отмены можно использовать хуки WooCommerce, например, woocommerce_order_status_processing или свой триггер:

add_action('woocommerce_order_status_processing', 'wp7_auto_cancel_processing_order');
function wp7_auto_cancel_processing_order($order_id) {
    // Добавьте сюда условие для отмены
    $order = wc_get_order($order_id);
    if (!$order) {
        return;
    }

    // К примеру, отменяем, если в заказе есть товар с ID 999
    foreach ($order->get_items() as $item) {
        if ($item->get_product_id() === 999) {
            wp7_cancel_order_after_payment($order_id);
            break;
        }
    }
}

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

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

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

• Ошибка: Статус не меняется, заказ остаётся processing.
  Причина: Функция не вызывается или ошибка в логике проверки.
  Решение: Добавьте error_log и проверьте вызов функции, убедитесь, что используете правильный хук.
• Ошибка: Возврат платежа не происходит.
  Причина: Платёжный шлюз не поддерживает автоматические рефанды через WooCommerce API.
  Решение: Проверьте документацию платежного шлюза, возможно, нужен дополнительный вызов API вручную.
• Ошибка: Функция вызывает фатальную ошибку из-за отсутствия метода.
  Причина: Метод refund отсутствует у объекта заказа.
  Решение: Используйте глобальную функцию wc_create_refund и убедитесь в правильности параметров.

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

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

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