Решение проблемы необновления статусов возврата платежа WooCommerce в LearnPress

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

При использовании LearnPress совместно с WooCommerce пользователи часто сталкиваются с ситуацией, когда статус возврата платежа (refund) в WooCommerce меняется, но соответствующий статус в LearnPress не обновляется автоматически. Это приводит к рассинхронизации данных, неправильному отображению статусов курсов и может вызвать проблемы с доступом учащихся к материалам.

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

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

Проверка логов и событий

Включите режим отладки WooCommerce и LearnPress, чтобы отследить, вызываются ли соответствующие хуки. Для WooCommerce это можно сделать, добавив в wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

После этого проверьте файл wp-content/debug.log на наличие ошибок, связанных с обновлением статусов возврата.

Пошаговое решение: синхронизация статусов возврата платежа

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

1. Подключение хука для отслеживания возвратов

WooCommerce триггерит хук woocommerce_order_status_refunded при возврате платежа. Используем его для вызова функции обновления статуса курса.

add_action('woocommerce_order_status_refunded', 'lp_sync_refund_status_with_learnpress', 10, 1);

function lp_sync_refund_status_with_learnpress($order_id) {
    if (!$order_id) return;

    $order = wc_get_order($order_id);
    if (!$order) return;

    // Получаем ID пользователя, сделавшего заказ
    $user_id = $order->get_user_id();
    if (!$user_id) return;

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

    foreach ($items as $item) {
        $product_id = $item->get_product_id();

        // Проверяем, что продукт это курс LearnPress
        if (learn_press_get_course_post_type() === get_post_type($product_id)) {
            // Получаем ID курса
            $course_id = $product_id;

            // Обновляем статус курса для пользователя на 'refunded' или 'cancelled'
            LP_User_Item::update_user_item_status($user_id, $course_id, 'cancelled');
        }
    }
}

2. Обновление статусов курсов в LearnPress

В приведенном коде используется статический метод LP_User_Item::update_user_item_status для смены статуса курса у пользователя. Этот метод стандартно поддерживается LearnPress и корректно обновляет записи в базе.

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

• Создайте тестовый заказ курса через WooCommerce.
• В панели WooCommerce выполните возврат платежа (refund) для этого заказа.
• Перейдите в админку LearnPress, откройте профиль пользователя и проверьте статус курса — он должен измениться на cancelled или другой, который вы указали.
• Проверьте логи ошибок — их не должно быть.
• Проверьте фронтенд для пользователя — доступ к курсу должен быть ограничен, если это предусмотрено логикой LearnPress для статуса cancelled.

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

• Хук не срабатывает: Проверьте, что функция подключена в functions.php или в плагине, и что при возврате в WooCommerce действительно меняется статус на refunded. Иногда возвращают деньги вручную без изменения статуса.
• Неверный тип поста у продукта: Убедитесь, что курсы LearnPress имеют правильный тип записи, обычно lp_course, и что learn_press_get_course_post_type() возвращает правильное значение.
• Проблемы с правами доступа: Функция должна работать от имени администратора или пользователя с нужными правами, чтобы менять статусы. Проверьте права пользователя, если вызываете функцию вручную.
• Конфликты с другими плагинами: Отключите временно все плагины кроме LearnPress и WooCommerce, чтобы проверить, не мешают ли они обработке событий.

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

• Код лучше добавить в отдельный кастомный плагин, а не в functions.php, чтобы избежать потери изменений при обновлении темы.
• Используйте проверку nonce и прав пользователя, если добавляете формы или AJAX-запросы, связанные с обновлением статусов.
• Для больших интернет-школ с большим количеством заказов рассмотрите возможность асинхронной обработки возвратов с помощью WP-Cron или очередей задач, чтобы не нагружать сайт.
• Регулярно проверяйте логи ошибок и статусы заказов для своевременного выявления рассинхронизаций.

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