# Основная информация

Корзина — это механизм покупки, который позволяет объединять несколько товаров в одном заказе. Пользователь может купить товары любого типа в любом количестве за реальную валюту, а также использовать [промокоды](https://developers.xsolla.com/ru/api/liveops/promotions-promo-codes).

Корзина хранится на стороне Xsolla. Сохранение корзины между сессиями зависит от того, авторизован ли пользователь:
  * Для авторизованных пользователей корзина привязана к конкретному пользователю и сохраняется между сессиями, пока запросы выполняются от имени того же пользователя.

  * Для [неавторизованных пользователей](/ru/api/catalog/authentication-with-guest-access-support) сохранение корзины зависит от передачи заголовка `x-unauthorized-id`. Чтобы сохранить корзину неавторизованного пользователя между сессиями, передавайте один и тот же `x-unauthorized-id` в каждом запросе. Этот вариант доступен только при продаже игровых ключей.

Вы можете идентифицировать корзину двумя способами: автоматически по [JWT пользователя](https://developers.xsolla.com/ru/api/catalog/authentication-using-users-jwt) или по ID корзины (`cart_id`).

Управление корзиной доступно как на стороне клиента, так и на стороне сервера.

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

* получить корзину текущего пользователя или по ID корзины;
* наполнить корзину;
* обновить товары в корзине;
* удалить товары из корзины.

Для оплаты товаров из корзины используются клиентские и серверные методы создания заказа.

По умолчанию время жизни корзины — 72 часа. Если состав корзины изменился, например при добавлении нового товара, ее время жизни продлевается.

После успешной оплаты корзина не очищается автоматически. Чтобы очистить корзину, используйте следующие клиентские методы API:
  * [Удаление всех товаров из корзины по ID корзины](/ru/api/catalog/cart-client-side/cart-clear-by-id).

  * [Удаление всех товаров из текущей корзины](/ru/api/catalog/cart-client-side/cart-clear).

  * [Удаление товара из корзины по ID корзины](/ru/api/catalog/cart-client-side/delete-item-by-cart-id) и [Удаление товара из текущей корзины](/ru/api/catalog/cart-client-side/delete-item) — корзина очищается, когда вы удаляете последний товар из нее.

Сценарий использования корзины:

1. Реализуйте интерфейс магазина, в котором пользователь будет выбирать товары.

2. Когда пользователь выбирает товары в магазине, добавьте их в корзину, например с помощью метода [Наполнение корзины товарами](https://developers.xsolla.com/ru/api/catalog/cart-client-side/cart-fill). В массиве items необходимо передать артикулы и количество необходимых товаров.

3. Реализуйте интерфейс просмотра корзины. При переходе пользователя в корзину отобразите ее содержимое с помощью метода [Получение корзины текущего пользователя](https://developers.xsolla.com/ru/api/catalog/cart-client-side/get-user-cart). В ответе отобразится информация об итоговой цене товаров с учетом скидок, а также примененных акциях.

4. Реализуйте открытие платежного интерфейса для оплаты заказа. Например, вы можете вызвать метод [Создание заказа со всеми товарами из определенной корзины](https://developers.xsolla.com/ru/api/catalog/payment-client-side/create-order-by-cart-id). В ответе вы получите токен для открытия платежного интерфейса.

5. Настройте отслеживание статуса заказа, например с помощью [вебхуков](https://developers.xsolla.com/ru/webhooks/), чтобы своевременно получать данные об успешно оплаченных товарах и начислять их пользователю.

<div class="note">
  <p><b>Примечание</b></p>
  <p>Подробная информация о настройке продажи товаров в игре и онлайн приведена в <a href="https://developers.xsolla.com/ru/virtual-goods/own-ui/">руководстве по интеграции</a>.</p>
</div>

![Сценарий использования корзины](https://cdn.xsolla.net/developers/current/images/api_docs/cart-payment-flow.svg)