Автоматическое изменение статуса заказа WooCommerce при оплате PayPal

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

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

Для диагностики проблемы выполните следующие шаги:

• Проверьте логи PayPal в WooCommerce (WooCommerce > Статус > Логи) на предмет ошибок IPN (Instant Payment Notification).
• Убедитесь, что IPN включён в вашем аккаунте PayPal и URL правильно настроен.
• Проверьте, что в настройках WooCommerce > Платежи > PayPal выбран правильный режим (тестовый или боевой).
• Проверьте, не конфликтуют ли плагины, отключив все, кроме WooCommerce и PayPal-пеймента.

Как WooCommerce меняет статус заказа при оплате PayPal

WooCommerce использует IPN для получения уведомления об оплате от PayPal. При получении подтверждения оплаты WooCommerce автоматически меняет статус заказа. Если IPN не приходит или обработка не срабатывает, статус не меняется.

Типичные статусы изменения:

• pending (ожидание оплаты) → processing (обработка) — для товаров, требующих доставки;
• pending → completed (завершён) — для цифровых товаров.

Пошаговое решение: корректное обновление статуса заказа при оплате PayPal

1. Проверка и настройка IPN в PayPal

Перейдите в настройки вашего аккаунта PayPal:

• Войдите в PayPal Business аккаунт.
• Перейдите в Настройки продавца (Seller Preferences) > Instant Payment Notification Preferences.
• Включите IPN и укажите URL: https://your-site.com/?wc-api=WC_Gateway_Paypal (замените your-site.com на ваш домен).
• Сохраните изменения.

2. Включение и настройка PayPal в WooCommerce

В админке WordPress выберите WooCommerce > Настройки > Платежи > PayPal:

• Включите платежный метод.
• Укажите корректный email PayPal.
• Выберите правильный режим (тестовый или боевой).

3. Добавление кода для ручного обновления статуса заказа (если стандартный механизм не работает)

Если после проверки IPN статус не меняется, можно добавить в functions.php дочерней темы следующий код, который обновит статус заказа при подтверждении оплаты PayPal:

add_action('woocommerce_api_wc_gateway_paypal', 'custom_paypal_ipn_handler');
function custom_paypal_ipn_handler() {
    $ipn = new WC_Gateway_Paypal();
    $ipn->check_ipn_response();
}

add_action('woocommerce_payment_complete', 'custom_update_order_status_paypal');
function custom_update_order_status_paypal($order_id) {
    if (!$order_id) {
        return;
    }
    $order = wc_get_order($order_id);
    if ($order->get_payment_method() !== 'paypal') {
        return;
    }
    if ($order->get_status() === 'pending') {
        $order->update_status('processing', 'Статус обновлен автоматически после оплаты PayPal');
    }
}

Этот код слушает IPN и вручную обновляет статус с «pending» на «processing» для заказов с оплатой PayPal.

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

• Сделайте тестовый заказ с оплатой PayPal.
• Убедитесь, что заказ меняет статус с «Ожидание оплаты» на «Обработка» или «Завершён» автоматически.
• Проверьте логи WooCommerce: WooCommerce > Статус > Логи, выберите последние записи PayPal IPN для подтверждения успешной обработки.
• Если вы используете тестовый режим PayPal Sandbox, убедитесь, что IPN включён и работает.

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

• IPN отключён или неправильный URL — проверьте настройки в PayPal и укажите правильный URL.
• Конфликты с другими плагинами — отключите сторонние плагины и проверьте работу PayPal.
• Ошибка в теме или functions.php — временно переключитесь на стандартную тему Twenty Twenty-One и проверьте.
• Проблемы с SSL — PayPal требует HTTPS, убедитесь, что сертификат установлен и сайт доступен по HTTPS.
• Кэширование страницы IPN — исключите URL ?wc-api=WC_Gateway_Paypal из кэширования (например, в настройках плагина кеширования).

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

• Используйте SSL на сайте — PayPal требует защищённое соединение для IPN.
• Исключайте URL IPN из кэша, чтобы уведомления доходили корректно.
• Регулярно проверяйте логи IPN в WooCommerce для своевременного выявления ошибок.
• Для масштабируемых магазинов рассмотрите использование webhook PayPal (PayPal REST API) вместо IPN для более надежного обновления статусов.
• Обновляйте WooCommerce и плагины для корректной работы интеграции.

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