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

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

В стандартной конфигурации WooCommerce для оплаты Почтой России (например, через платежные методы с наличной оплатой при получении) заказ обычно создается со статусом on-hold или pending. Однако, в большинстве случаев необходимо, чтобы статус автоматически менялся на processing или completed после подтверждения оплаты, чтобы не требовать ручного вмешательства.

Если вы используете интеграцию Почты России с WooCommerce, но статус заказа не обновляется автоматически, возможные причины:

• Отсутствует обработчик события подтверждения оплаты в системе.
• Плагин или интеграция Почты России не посылает корректный webhook или callback.
• Кэширование сайта или плагинов мешает обновлению статуса.
• Некорректный статус заказа в WooCommerce, не подходящий для автоматического перехода.

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

1. Добавление обработчика смены статуса при получении подтверждения оплаты

Предположим, что платеж через Почту России регистрируется в WooCommerce с помощью метода оплаты, который устанавливает статус заказа on-hold. Чтобы автоматически изменить статус на processing, когда вы получите подтверждение оплаты (например, через webhook или ручную отметку), можно добавить следующий код в файл functions.php вашей темы или в отдельный плагин:

add_action('woocommerce_order_status_on-hold', 'auto_change_order_status_after_payment', 10, 1); 
function auto_change_order_status_after_payment($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);

    // Проверяем, что метод оплаты Почта России
    if ($order->get_payment_method() === 'pochta_rossii') {
        // Меняем статус на processing
        $order->update_status('processing', 'Автоматическое обновление статуса после оплаты Почтой России');
    }
}

Замените pochta_rossii на ID вашего платежного метода Почты России, если он отличается.

2. Обработка webhook от Почты России (если есть)

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

add_action('init', 'pochta_rossii_webhook_listener');
function pochta_rossii_webhook_listener() {
    if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_GET['pochta_webhook'])) {
        $input = file_get_contents('php://input');
        $data = json_decode($input, true);

        if (empty($data['order_id']) || empty($data['payment_status'])) {
            status_header(400);
            exit('Invalid data');
        }

        $order_id = intval($data['order_id']);
        $payment_status = sanitize_text_field($data['payment_status']);

        $order = wc_get_order($order_id);
        if (!$order) {
            status_header(404);
            exit('Order not found');
        }

        if ($payment_status === 'paid' && $order->get_status() === 'on-hold') {
            $order->update_status('processing', 'Оплата подтверждена Почтой России через webhook');
        }

        status_header(200);
        exit('OK');
    }
}

Вызов этого обработчика будет выглядеть так: https://example.com/?pochta_webhook=1 — настройте отправку webhook с вашей стороны.

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

• Создайте тестовый заказ с методом оплаты Почта России.
• Убедитесь, что первоначальный статус заказа on-hold или pending.
• Если вы используете webhook, отправьте тестовый POST-запрос с данными {"order_id":123,"payment_status":"paid"} на адрес вашего сайта ?pochta_webhook=1.
• Проверьте, что статус заказа изменился на processing.
• Если используете первый метод, переведите заказ в статус on-hold и убедитесь, что автоматическое изменение сработает.

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

• Неправильный ID метода оплаты: Проверьте точное значение $order->get_payment_method(), например через error_log($order->get_payment_method()), чтобы не использовать неверный идентификатор.
• Кэширование блокирует обновление статуса: Очистите весь кэш сайта, а также серверный кэш, если используется (Redis, Memcached).
• Webhook не вызывается или возвращает ошибку: Проверьте логи сервера, убедитесь, что URL доступен и настроен правильно.
• Статус заказа не меняется, т.к. он уже в нужном статусе: Добавьте логирование или отладку, чтобы понять, вызывается ли функция обновления статуса.

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

• Валидация данных webhook: Проверяйте подписи, IP-адреса или другие механизмы аутентификации, чтобы не допустить подделку запросов.
• Минимизируйте нагрузку: Обновление статуса заказа не должно запускать тяжелые операции. Если требуется, используйте WP-Cron для отложенного выполнения.
• Записывайте логи ошибок и успешных обновлений: Это поможет быстро диагностировать проблемы в будущем.

Сравнение вариантов реализации