WooCommerce: как автоматически изменять статус заказа при оплате Почтой России

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

В WooCommerce по умолчанию нет интеграции с Почтой России, которая бы автоматически меняла статус заказа при оплате. Из-за этого заказы, оплаченные при получении (наложенный платеж), остаются в статусе "Ожидает оплаты" или "Обработка", что мешает дальнейшей работе с заказами и информированию клиентов.

Типичные признаки проблемы:

• Заказы с доставкой Почтой России долго остаются в статусе "Ожидает оплаты".
• Автоматические уведомления клиентам не отправляются в нужный момент.
• Ручное изменение статуса занимает много времени при большом количестве заказов.

Как настроить автоматическое изменение статуса заказа для наложенного платежа Почтой России

1. Определяем способ оплаты для Почты России

Для начала убедитесь, что у вас есть отдельный способ оплаты для Почты России, например «Наложенный платеж Почтой России». Если его нет, создайте в WooCommerce способ оплаты "Наложенный платеж" или используйте плагин для интеграции с Почтой России.

2. Добавляем хук для автоматического изменения статуса заказа

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

add_action('woocommerce_thankyou', 'auto_change_order_status_for_russian_post', 10, 1);
function auto_change_order_status_for_russian_post($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);

    // ID способа оплаты для Почты России
    $payment_method = $order->get_payment_method();
    if ($payment_method !== 'cod_russian_post') { // Укажите ваш slug способа оплаты
        return;
    }

    // Проверяем, что заказ в статусе "обработка" или "ожидает оплаты"
    if (in_array($order->get_status(), ['processing', 'on-hold'])) {
        // Меняем статус на "completed" или другой нужный
        $order->update_status('completed', 'Статус автоматически изменён после оплаты Почтой России');
    }
}

В данном примере cod_russian_post — это slug способа оплаты, который нужно заменить на ваш.

3. Обработка данных от Почты России (опционально)

Если у вас есть API или webhook от Почты России, можно реализовать более точное обновление статуса заказа по получению подтверждения оплаты. Для этого потребуется:

• Настроить прием webhook на вашем сайте.
• Обработать входящие данные и идентифицировать заказ.
• Обновить статус заказа через $order->update_status().

Это более сложный вариант, требующий программирования и настройки API Почты России.

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

Чтобы убедиться, что автоматическое изменение статуса работает:

• Создайте тестовый заказ с оплатой способом Почты России.
• Перейдите на страницу благодарности (thankyou), чтобы триггерить хук woocommerce_thankyou.
• Проверьте в админке WooCommerce, что статус заказа изменился на completed или заданный вами.
• Для webhook-решения — отправьте тестовый запрос с данными оплаты и проверьте обновление статуса.

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

• Неправильный slug способа оплаты: Проверьте точное имя способа оплаты через var_dump($order->get_payment_method()) или в админке WooCommerce.
• Код не срабатывает: Убедитесь, что код добавлен в правильное место (functions.php дочерней темы или плагин), и нет синтаксических ошибок.
• Статус не меняется, т.к. заказ в неподходящем статусе: Проверьте, что условие в коде позволяет менять именно ваш статус заказа.
• Проблемы с кешированием: При использовании кеширующих плагинов убедитесь, что страница thankyou не кешируется.

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

• Всегда тестируйте код на тестовом сайте перед внедрением в продакшен.
• Для работы с API Почты России используйте безопасные методы аутентификации и фильтры входящих данных.
• Не отключайте кеширование на всех страницах сайта — ограничьте кеш только для страниц заказа и thankyou.
• Для масштабируемости лучше использовать webhook от Почты России, а не полагаться только на хук woocommerce_thankyou.

Сравнение вариантов реализации автоматического изменения статуса