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

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

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

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

Пошаговое решение: как изменить статус заказа без изменения суммы

1. Отключить автоматическое повторное выставление счета или повторную авторизацию

Если ваш платежный шлюз поддерживает автоматическое переавторизование платежа при изменении статуса, попробуйте отключить эту опцию в настройках плагина. Например, для популярных шлюзов, таких как WooCommerce Stripe или WooCommerce PayPal, проверьте параметры, связанные с "Capture Charge" или "Auto Capture".

2. Использовать стандартный метод изменения статуса заказа через API без вызова перерасчёта

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

function change_order_status_without_payment_increase( $order_id, $new_status ) {
    if ( ! $order_id || ! $new_status ) {
        return;
    }
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return;
    }
    // Меняем статус без вызова дополнительных функций
    $order->set_status( $new_status );
    $order->save();
}

Используйте этот код в кастомных плагинах или в functions.php, чтобы избежать ненужных перерасчетов.

3. Проверить хуки и фильтры, которые могут влиять на перерасчет стоимости

Проверьте, не добавляют ли сторонние плагины или кастомные функции обработчики на хуки woocommerce_order_status_changed или woocommerce_checkout_update_order_meta, которые вызывают пересчет или повторное выставление счета.

add_action( 'woocommerce_order_status_changed', 'custom_order_status_change_handler', 10, 4 );
function custom_order_status_change_handler( $order_id, $old_status, $new_status, $order ) {
    // Проверьте, не вызывается ли здесь перерасчет суммы
}

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

После внесения изменений выполните следующие шаги, чтобы убедиться, что проблема решена:

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

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

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

• Ошибка: Использование метода $order->calculate_totals() при смене статуса без необходимости.
  Исправление: Не вызывайте этот метод при просто смене статуса, если не меняете содержимое заказа.
• Ошибка: Автоматический повторный захват платежа в настройках платежного шлюза.
  Исправление: Отключите автоматический захват в настройках плагина платежного шлюза.
• Ошибка: Кастомные хуки, вызывающие обновление метаданных заказа или пересчет.
  Исправление: Проверьте код на наличие таких хуков и отключите их для статусов, где не нужен перерасчет.

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

• Используйте nonce и проверки прав доступа при реализации программного изменения статуса через AJAX или REST API.
• Избегайте лишних запросов к базе данных и повторных вызовов функций пересчета при массовом обновлении заказов.
• Тестируйте изменения в безопасной среде перед внедрением на боевой сайт.

Сравнение вариантов изменения статуса заказа в WooCommerce