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

Проблема несинхронизации статусов заказов WooCommerce и LearnPress

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

Диагностика проблемы

• Проверьте, какая платежная система используется и поддерживает ли она стандартные хуки WooCommerce.
• Откройте журнал WooCommerce (WooCommerce > Статус > Логи) и найдите ошибки, связанные с обновлением заказов.
• Проверьте, вызывается ли в LearnPress функция обновления статуса заказа после изменения статуса WooCommerce.
• Убедитесь, что нет конфликтов с другими плагинами, которые могут перехватывать обработку статусов заказов.

Как реализовать корректную синхронизацию статусов

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

Пошаговое решение с кодом

Добавьте следующий код в functions.php вашей темы или в отдельный плагин:

add_action('woocommerce_order_status_changed', 'lp_sync_order_status_with_learnpress', 10, 4);
function lp_sync_order_status_with_learnpress($order_id, $old_status, $new_status, $order) {
    // Получаем объект заказа LearnPress по ID WooCommerce заказа
    $lp_order = learn_press_get_order($order_id);
    if (!$lp_order) {
        return; // Если заказ LearnPress не найден, выходим
    }

    // Сопоставляем статусы WooCommerce с LearnPress
    switch ($new_status) {
        case 'completed':
            $lp_order->set_status('completed');
            break;
        case 'processing':
            $lp_order->set_status('processing');
            break;
        case 'cancelled':
        case 'refunded':
        case 'failed':
            $lp_order->set_status('cancelled');
            break;
        default:
            // Можно добавить другие соответствия по необходимости
            break;
    }
    // Сохраняем изменения
    $lp_order->save();
}

Этот код слушает событие смены статуса WooCommerce заказа и обновляет статус заказа в LearnPress. Убедитесь, что функция learn_press_get_order() доступна и корректно возвращает объект заказа LearnPress.

Обработка нестандартных платежных систем

Если вы используете нестандартные или кастомные платежные шлюзы, они могут не менять стандартные статусы заказов WooCommerce. В этом случае:

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

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

Чтобы убедиться, что синхронизация работает:

• Создайте тестовый заказ через WooCommerce с выбранной платежной системой.
• Оплатите заказ (можно использовать тестовый режим платежного шлюза).
• После успешной оплаты проверьте статус заказа в WooCommerce и LearnPress — они должны совпадать.
• Убедитесь, что учащийся получил доступ к курсу в LearnPress.

Частые ошибки и способы их устранения

• Отсутствие объекта заказа LearnPress. Может произойти, если ID заказа WooCommerce не совпадает с ID заказа LearnPress. Проверьте, что заказы создаются синхронно.
• Код добавлен, но статусы не меняются. Проверьте, что хук woocommerce_order_status_changed вызывается и что нет конфликтов с другими плагинами.
• Платежная система не меняет статус заказа WooCommerce. В этом случае нужно добавить обработчик событий платежного шлюза или вручную обновлять статус заказа.
• Ошибки PHP при вызове методов объекта заказа LearnPress. Убедитесь, что LearnPress установлен и активен, а используемые методы актуальны для вашей версии.

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

• Добавляйте обработчики статусов с приоритетом, чтобы избежать конфликтов с другими плагинами.
• Используйте проверку существования объекта заказа перед его изменением.
• Не делайте тяжелых операций в хуках обновления статусов — это влияет на скорость обработки клиентов.
• Для логирования ошибок используйте стандартный лог WooCommerce или отдельный лог-файл, не выводите ошибки на экран.

Сравнение вариантов решения синхронизации