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

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

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

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

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

1. Определяем событие отклонения платежа

Для большинства шлюзов WooCommerce генерирует событие <gateway>_payment_failed, либо меняет статус заказа на "failed" или "cancelled". Но в случаях, когда этого не происходит, можно воспользоваться универсальным хуком woocommerce_order_status_changed и проверить статус платежа вручную.

2. Добавляем пользовательский обработчик

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

add_action('woocommerce_order_status_pending_to_processing', 'custom_fail_order_on_payment_decline', 10, 1);
add_action('woocommerce_order_status_pending_to_on-hold', 'custom_fail_order_on_payment_decline', 10, 1);

function custom_fail_order_on_payment_decline($order) {
    // Получаем ID платежного шлюза
    $payment_method = $order->get_payment_method();

    // Пример для конкретного шлюза (укажите ваш)
    if ($payment_method === 'your_gateway_id') {
        // Проверяем мета-данные или статус платежа
        $payment_status = $order->get_meta('_payment_status'); // пример мета-ключа

        if ($payment_status === 'declined' || $payment_status === 'failed') {
            $order->update_status('failed', __('Платеж отклонен автоматически', 'woocommerce'));
        }
    }
}

Замените your_gateway_id на ID вашего платежного шлюза (например, stripe, paypal и т.д.). Метаданные _payment_status нужно уточнить, как их записывает конкретный шлюз — можно посмотреть в базе данных в таблице wp_postmeta.

3. Обработка других сценариев

Если платежный шлюз не добавляет мета-данные, используйте хук woocommerce_payment_failed. Пример:

add_action('woocommerce_payment_failed', 'handle_payment_failed', 10, 2);
function handle_payment_failed($order_id, $payment_method) {
    $order = wc_get_order($order_id);
    if (!$order) {
        return;
    }

    // По желанию проверяем метод оплаты
    if ($payment_method === 'your_gateway_id') {
        $order->update_status('failed', __('Платеж отклонен автоматически через хук', 'woocommerce'));
    }
}

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

• Создайте тестовый заказ с использованием проблемного платежного шлюза.
• Инициируйте отклонение платежа (например, через тестовый режим или недопустимые данные карты).
• В админке WooCommerce убедитесь, что статус заказа меняется на "Неудачный" (failed) автоматически.
• Проверьте историю статусов заказа и комментарии к заказу — должен появиться ваш кастомный комментарий.

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

• Неверный ID платежного шлюза: проверьте идентификатор в настройках WooCommerce - Настройки - Платежи.
• Отсутствие мета-данных о статусе платежа: уточните у разработчика платежного шлюза или изучите базу данных, чтобы понять, какие поля указывают статус.
• Хук срабатывает не для всех переходов статусов: добавьте дополнительные хуки для других переходов статусов, например, woocommerce_order_status_on-hold_to_processing и т.д.
• Конфликты с другими плагинами: временно отключите другие плагины, чтобы проверить, не перехватывают ли они события обновления статуса.

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

• Не используйте тяжелые запросы к базе данных внутри хуков, чтобы не замедлять процесс обновления статуса.
• Кэшируйте данные, если нужно часто проверять статус платежа во внешних API.
• Убедитесь, что пользовательские сообщения в истории заказа не раскрывают чувствительную информацию о платеже.

Сравнение вариантов решения задачи