WooCommerce: автоматическое удаление товаров из корзины после отмены оплаты

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

В стандартной работе WooCommerce, если пользователь начал оформление заказа, добавил товары в корзину, но по каким-то причинам отменил оплату (например, закрыл страницу оплаты или при оплате через внешний шлюз получена ошибка), товары остаются в корзине. Это может вызвать путаницу и неудобства, особенно если пользователь возвращается на сайт, а корзина заполнена старыми товарами.

Если вы хотите обеспечить более чистый и предсказуемый UX, стоит реализовать автоматическое удаление товаров из корзины после отмены оплаты.

Как работает корзина в WooCommerce

Корзина WooCommerce хранится в сессии пользователя и в куках браузера. При оформлении заказа создаётся объект заказа с определённым статусом. Если оплата не прошла или была отменена, заказ либо остаётся в статусе pending, либо изменяется на failed.

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

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

Добавим обработчик на изменение статуса заказа, который будет очищать корзину пользователя при смене статуса на cancelled, failed или refunded. Вот рабочий пример кода, который нужно добавить в файл functions.php вашей темы или в кастомный плагин:

add_action('woocommerce_order_status_changed', 'clear_cart_on_payment_cancelled', 10, 4);
function clear_cart_on_payment_cancelled($order_id, $old_status, $new_status, $order) {
    // Статусы, при которых нужно очистить корзину
    $statuses_to_clear = array('cancelled', 'failed', 'refunded');

    if (in_array($new_status, $statuses_to_clear)) {
        // Получаем ID пользователя, если он авторизован
        $user_id = $order->get_user_id();
        if ($user_id) {
            // Очистка корзины для авторизованного пользователя
            WC()->cart->empty_cart();
        } else {
            // Если покупатель гость, очищаем корзину в сессии
            WC()->cart->empty_cart();
        }
    }
}

Обратите внимание, что данный код работает при условии, что пользователь находится в той же сессии, что и при оформлении заказа. Для гостей это особенно важно, так как корзина хранится только в сессии браузера.

Обработка отмены оплаты через хуки платежных шлюзов

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

Как проверить, что решение работает

1. Добавьте товары в корзину как авторизованный пользователь или гость.
2. Перейдите к оформлению заказа и инициируйте оплату, но отмените её (например, закройте страницу оплаты или используйте тестовый режим для провала транзакции).
3. Убедитесь, что после возврата на сайт корзина пуста.
4. Проверьте разные статусы заказов в админке WooCommerce (cancelled, failed, refunded) и повторите тест.

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

• Корзина не очищается для гостей: корзина хранится в сессии, убедитесь, что пользователь не меняет браузеры или устройства. В противном случае очистка невозможна без дополнительного хранения корзины в базе.
• Очистка происходит слишком рано или часто: проверьте, что хук срабатывает только при смене статуса, а не при каждом сохранении заказа.
• Конфликты с другими плагинами: некоторые плагины могут переопределять работу с корзиной. В таком случае попробуйте приоритет хука повысить до 20 или выше.
• Очистка корзины удаляет товары неожиданно: убедитесь, что условие на новые статусы четко определено и не срабатывает при успешных заказах.

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

• Не используйте очистку корзины при каждом изменении заказа — только при смене статуса на отменённый или неудачный.
• Для масштабируемых сайтов с большим количеством гостей можно рассмотреть хранение корзины в базе данных для отслеживания и очистки.
• Для интеграции с платёжными шлюзами изучите их вебхуки — это позволит более точно реагировать на события оплаты и отмены.
• Тестируйте изменения в staging-среде, чтобы избежать потери данных покупателей.

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