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

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

В WooCommerce часто возникает задача автоматически менять статус заказа, когда меняется статус платежа, особенно если используются нестандартные шлюзы или ручная обработка платежей. Иногда заказ остается в статусе on-hold или pending, хотя деньги уже получены, что мешает дальнейшей обработке и уведомлениям.

Чтобы проверить наличие проблемы, откройте заказ в админке WooCommerce, обратите внимание на текущий статус и платежный журнал. Если платеж подтвержден, но статус не обновлен, значит задача актуальна.

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

1. Использование хука woocommerce_order_status_changed для отслеживания изменений

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

2. Добавление кастомного кода в functions.php или плагин

Ниже пример кода, который автоматически переводит заказ в статус processing, если платеж был успешно завершен, и в cancelled — если платеж отменен.

add_action('woocommerce_order_status_changed', 'auto_update_order_status_on_payment_change', 10, 4);
function auto_update_order_status_on_payment_change($order_id, $old_status, $new_status, $order) {
    // Проверяем, что заказ существует
    if (!$order) {
        $order = wc_get_order($order_id);
    }

    // Получаем статус оплаты
    $payment_status = $order->get_payment_method_title(); // пример получения платежного метода

    // Логика изменения статуса в зависимости от платежа
    // Здесь можно добавить проверку статуса платежа через API шлюза или мета-поля

    if ($new_status === 'on-hold' && $order->is_paid()) {
        $order->update_status('processing', 'Статус автоматически обновлен: платеж подтвержден.');
    } elseif ($new_status === 'processing' && !$order->is_paid()) {
        $order->update_status('cancelled', 'Статус автоматически обновлен: платеж отменен.');
    }
}

3. Проверка статуса платежа через мета-поля или API платежного шлюза

Для более точной проверки можно получить статус платежа из мета-полей заказа или напрямую из API используемого платежного шлюза. Например, для WooCommerce Stripe можно использовать их вебхуки для синхронизации статусов.

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

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

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

• Код не срабатывает: проверьте, что функция подключена и нет синтаксических ошибок, а также что хук правильно использован.
• Статус не меняется из-за кеширования: иногда кеширование или сторонние плагины блокируют обновления. Очистите кеш и временно отключите плагины кеширования.
• Неправильная проверка платежа: используйте надежный источник данных о статусе платежа. Методы is_paid() или мета-поля могут не всегда отражать реальное состояние.
• Конфликты с другими плагинами: отключите другие плагины, которые могут взаимодействовать со статусами заказов.

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

• Не храните ключи API платежных шлюзов в коде, используйте защищённые способы хранения (например, wp-config.php).
• Обрабатывайте вебхуки платежных систем асинхронно, чтобы не блокировать загрузку сайта.
• Проверяйте права доступа и безопасность данных при работе с заказами и платежами.
• Логируйте изменения статусов для возможности аудита и отладки.

Сравнение подходов к автоматическому обновлению статуса заказа