Как решить проблему несинхронизации статусов заказов WooCommerce и LearnPress при использовании различных платежных систем

Диагностика проблемы несинхронизации статусов заказов

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

Чтобы убедиться в проблеме, выполните следующие проверки:

• Проверьте, что заказ в WooCommerce имеет статус completed или processing, а в LearnPress статус оплаты не обновился.
• Посмотрите логи платежного шлюза — подтвердился ли платеж и были ли ошибки при callback.
• Проверьте, включена ли синхронизация статусов заказов между WooCommerce и LearnPress в настройках плагинов.

Почему возникает рассинхронизация статусов платежей

Основные причины проблемы:

• Платежные системы используют разные статусы и механизмы уведомления (IPN, webhooks), которые LearnPress не всегда корректно распознает.
• Некорректная обработка callback-запросов, например, из-за конфликтов с другими плагинами безопасности или кэширования.
• Отсутствие или неправильная настройка хуков, которые переводят статус заказа WooCommerce в статус оплаты курса LearnPress.

Пошаговое решение проблемы

1. Проверка и настройка webhook или IPN платежной системы

Убедитесь, что платежная система корректно отправляет уведомления на сайт. Для этого:

• Проверьте URL callback в настройках платежного шлюза.
• Убедитесь, что сервер принимает и обрабатывает вызовы (нет ошибок 403, 404, 500).
• Проверьте логи сервера и WooCommerce для ошибок.

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

Если LearnPress не обновляет статус по умолчанию, можно добавить свой обработчик на изменение статуса заказа WooCommerce и вручную обновить статус оплаты курса. Например:

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

    // Получаем ID пользователя и курсы из заказа
    $user_id = $order->get_user_id();
    $items = $order->get_items();

    foreach ($items as $item) {
        $product_id = $item->get_product_id();
        // Проверяем, является ли продукт курсом LearnPress
        if (learn_press_get_course_by_product($product_id)) {
            // Обновляем статус оплаты курса
            learn_press_update_user_course_status($user_id, $product_id, 'enrolled');
        }
    }
}

// Вспомогательная функция для получения курса по продукту
function learn_press_get_course_by_product($product_id) {
    $course_id = get_post_meta($product_id, '_lp_course', true);
    return $course_id ? $course_id : false;
}

Обратите внимание, что функция learn_press_update_user_course_status — демонстрационная, в реальности нужно использовать API LearnPress или функции плагина для смены статуса курса пользователя. В LearnPress обычно для этого применяются методы класса LP_User_Course.

3. Настройка обработчиков статусов для других платежных систем

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

• Определите, какие статусы в WooCommerce означают успешную оплату для каждого шлюза.
• Добавьте экшены для этих статусов, аналогичные примеру выше.
• Проверьте, что статусы возврата платежа или отмены заказа также синхронизируются с LearnPress.

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

После внесения изменений:

• Сделайте тестовый заказ через каждую платежную систему на тестовом курсе.
• Убедитесь, что после успешной оплаты статус заказа в WooCommerce меняется на completed или нужный по настройке.
• Проверьте, что в LearnPress статус курса для пользователя обновился на «зачислен» или эквивалент.
• Попробуйте зайти под учетной записью пользователя и получить доступ к курсу — он должен открываться.

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

• Нет обновления статуса из-за кэширования: отключите кэширование страниц для страниц callback платежных систем, настройте исключения в плагинах кэширования.
• Обработчик не вызывается: убедитесь, что добавленный код подключен и нет синтаксических ошибок, используйте error_log для отладки.
• Неверное определение курсов в заказе: проверьте, что связь между продуктом WooCommerce и курсом LearnPress задана и правильно считывается.
• Конфликты с другими плагинами: временно отключите сторонние плагины безопасности и оптимизации, чтобы проверить влияние на callback.

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

• Обрабатывайте callback-запросы только от доверенных IP или с проверкой подписи платежной системы.
• Минимизируйте тяжелые операции в обработчиках статусов — сохранение данных лучше делать через отложенные задачи (cron).
• Используйте транзакции базы данных при обновлении статусов, чтобы избежать рассинхронизации.
• Логируйте критичные действия для последующего анализа проблем.

Сравнение подходов: плагин vs кастомный код