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

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

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

Стандартные настройки WooCommerce таких сценариев не предусматривают, а плагины часто избыточны или не дают гибкой настройки. Значит, нужен кастомный код, который сработает после смены статуса заказа на "оплачен" (например, "processing" или "completed") и обновит нужные поля адреса.

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

1. Определяем, какой статус заказа считать оплатой

В WooCommerce чаще всего оплатой считается переход заказа в статус processing или completed. Выберите подходящий для вашего магазина.

2. Используем хук woocommerce_order_status_{$status}

Этот хук срабатывает, когда заказ переходит в определённый статус. Например, для processing — woocommerce_order_status_processing.

3. Пишем функцию для обновления адреса доставки

В этой функции мы получаем объект заказа, меняем адрес доставки и сохраняем изменения.

add_action('woocommerce_order_status_processing', 'wpsource_update_shipping_address_after_payment');
function wpsource_update_shipping_address_after_payment($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Новый адрес доставки - пример, замените на ваш источник данных
    $new_shipping_address = [
        'first_name' => 'Иван',
        'last_name'  => 'Иванов',
        'company'    => 'ООО Ромашка',
        'address_1'  => 'ул. Новая, д. 10',
        'address_2'  => 'офис 5',
        'city'       => 'Москва',
        'state'      => 'MOW',
        'postcode'   => '123456',
        'country'    => 'RU'
    ];

    // Обновляем поля доставки
    foreach ($new_shipping_address as $key => $value) {
        $order->set_shipping_{$key}($value);
    }

    $order->save();
}

Обратите внимание: set_shipping_{$key} — это динамический вызов метода. В PHP можно сделать так:

foreach ($new_shipping_address as $key => $value) {
    $setter = 'set_shipping_' . $key;
    if (method_exists($order, $setter)) {
        $order->{$setter}($value);
    }
}

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

• Создайте тестовый заказ с любым адресом доставки.
• Оплатите заказ (тестовый режим платежной системы или вручную измените статус заказа на processing через админку).
• Перейдите в админку WooCommerce > Заказы и откройте изменённый заказ.
• Проверьте, что в разделе адреса доставки отображается новый адрес (тот, что прописан в коде).

Частые ошибки при автоматическом изменении адреса доставки

• Функция не срабатывает после оплаты: проверьте, что выбран правильный статус в хуке. Для некоторых платежных шлюзов может использоваться статус completed или кастомный.
• Адрес не обновляется: убедитесь, что используете методы set_shipping_* и вызываете $order->save() после изменений.
• Некорректный формат данных: все поля адреса должны соответствовать стандартам WooCommerce (например, страна — код ISO 3166-1 alpha-2).
• Изменения не видны клиенту: кэширование страниц или плагин-кэш может показывать старые данные. Очистите кэш и попробуйте снова.

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

• Не храните в коде реальные персональные данные — заменяйте адрес на актуальные данные из API платежной системы или других надежных источников.
• Используйте проверки и валидацию входящих данных, если адрес приходит из внешних систем.
• Следите за производительностью: не выполняйте тяжелые запросы внутри хука, если планируете массовые обновления заказов.
• Для отладки используйте логирование через error_log() или плагины типа Query Monitor.

Таблица сравнения вариантов реализации