WooCommerce: как изменить статус заказа без повышения суммы платежа

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

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

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

• При изменении статуса заказа (например, с 'обработка' на 'выполнен') сумма платежа в истории транзакций возрастает.
• Клиенты получают уведомления о необходимости доплаты без явной причины.
• В логах платежного шлюза фиксируются повторные запросы на изменение суммы.

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

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

1. Проверка хуков и фильтров, связанных с заказом

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

add_action('woocommerce_order_status_changed', function($order_id, $old_status, $new_status) {
    error_log("Order #" . $order_id . " status changed from " . $old_status . " to " . $new_status);
}, 10, 3);

Это поможет понять, когда именно меняется статус и какие функции могут влиять на платеж.

2. Отключение повторной инициализации платежа

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

Например, если используется кастомный код, который срабатывает на woocommerce_order_status_changed и вызывает обновление платежа, оберните этот код в условие:

add_action('woocommerce_order_status_changed', 'custom_update_payment', 20, 3);
function custom_update_payment($order_id, $old_status, $new_status) {
    // Обновляем платеж только при переходе в статус 'processing', чтобы не повышать сумму при других статусах
    if ($new_status !== 'processing') {
        return;
    }
    // Ваш код обновления платежа
}

3. Использование фильтра для предотвращения изменения суммы

Некоторые платежные шлюзы используют фильтры для изменения суммы заказа. Проверьте, нет ли у вас в коде фильтров, изменяющих сумму, например woocommerce_order_get_total или woocommerce_calculated_total. При необходимости отключите их при смене статуса:

add_filter('woocommerce_order_get_total', 'disable_total_modification_on_status_change', 10, 2);
function disable_total_modification_on_status_change($total, $order) {
    // Проверяем, что изменение происходит не при смене статуса, или возвращаем оригинальную сумму
    if (did_action('woocommerce_order_status_changed')) {
        return $order->get_meta('_original_total', true) ?: $total;
    }
    return $total;
}

Перед этим лучше сохранить оригинальную сумму заказа в мета-поле _original_total сразу после создания заказа.

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

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

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

• Ошибка: Повторная отправка платежных данных в шлюз происходит из-за вызова функции обновления платежа вне условий.
  Решение: Обернуть вызов в проверку статуса, как указано в примере выше.
• Ошибка: Фильтры, изменяющие сумму заказа, не учитывают контекст смены статуса.
  Решение: Добавить проверку наличия действия смены статуса и вернуть исходную сумму.
• Ошибка: Кэширование суммы заказа в плагинах кэширования или оптимизации.
  Решение: Очистить кэш и проверить поведение без кэширования.

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

• Всегда тестируйте изменения на staging-сервере, чтобы избежать сбоев в работе реальных заказов.
• Используйте error_log или плагин для логирования событий, чтобы отслеживать обработку статусов.
• Минимизируйте количество кастомных вызовов к платежным API при изменении статуса, чтобы снизить нагрузку и риск ошибок.
• При использовании сторонних плагинов для оплаты проверяйте их документацию на предмет особенностей обработки статусов заказа.

Таблица сравнения подходов