> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/api-guides-en/store-front-api/order-and-payment/cart.md).

# Cart

Manages the feature that lets users select products and add them to the cart, and is an essential element for beginning the order process.

Provides APIs so users can manage the products they want to order by adding, editing, and removing selected products in the cart.

{% columns %}
{% column %}

<p align="center"><strong>PC</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2F1YzKC8YB0hkMpLxtR656%2Fimage-20240416-045926.png?alt=media&#x26;token=8999eac7-eadb-4dcf-909d-aefbbfd78285" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<p align="center"><strong>Mobile</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2Fb8k4SkiJbrmRWxDPW5ij%2Fimage-20240416-045941.png?alt=media&#x26;token=4e679009-4b37-4476-9bd8-741a36b47a0a" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## Cart View Area <a href="#plus" id="plus"></a>

<div align="center"><img src="https://tech.x2bee.com/download/attachments/266110356/ShoppingBag.drawio.png" alt=""></div>

### 1. Look Up Cart <a href="#id-1" id="id-1"></a>

Looks up the list of products added to the cart.

1\) Member: looks up the cart by member number.

2\) Non-member: for non-members, a session number is generated when the cart is first created and stored in a cookie, and the cart is subsequently looked up using the session number retrieved from the cookie.<br>

* **Look up cart** ([🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=getBasket))\
  Looks up by member number or the non-member's cookie session number and outputs the composition information.

```
GET /v1/basket/getBasket
```

### 2. Look Up Customer Notification List <a href="#id-2" id="id-2"></a>

Looks up the top notice registered in the BO system's **Notice Management > Customer Notification Management** that appears at the top.​

* **Look up screen customer notification (**[🔗View API >](https://api.x2bee.com/content?msa=common\&depth=%EA%B3%B5%ED%86%B5\&path=getContsList))\
  Looks up the customer notification list.

```
GET /v1/common/getContsList 
```

### 3. Look Up Interest-Free Installment Information List <a href="#id-3" id="id-3"></a>

Clicking the text at the bottom of the cart calls and displays the promotion information registered in Interest-Free Installment Information management.

* **Look up interest-free installment information list (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EA%B2%B0%EC%A0%9C%EC%A0%95%EB%B3%B4/getInterestFreeList))\
  Looks up the interest-free installment information list for credit cards, etc.

```
GET /v1/payment/getInterestFreeList  
```

***

## Remove from Cart <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88_%EC%83%81%ED%92%88%EC%82%AD%EC%A0%9C.drawio.png)

### 1. Remove from Cart <a href="#id-1" id="id-1"></a>

Removes a sold-out or selected product from the cart list screen.

* **Remove from cart (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=deleteBasket))\
  Removes the selected product from the cart product list.

```
PUT /v1/basket/deleteBasket 
```

***

## Change Cart Option <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/%EC%87%BC%ED%95%91%EB%B0%B1%20%EC%83%81%ED%92%88%20%EC%98%B5%EC%85%98%EB%B3%80%EA%B2%BD.drawio.png)

### 1. Change Cart Option <a href="#id-1" id="id-1"></a>

Selecting the target product in the cart and clicking 'Change Option' shows the option and quantity change popup. Change the quantity and click \[Confirm Selection] to save the changed quantity.

* **Change cart option (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=optionChangeBasket))\
  Calls the cart product option change API when the 'Confirm Selection' button is clicked.

```
PUT /v1/basket/optionChange 
```

***

## Product Detail Gift Promotion List <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/%EC%87%BC%ED%95%91%EB%B0%B1%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC%EC%A1%B0%ED%9A%8C.drawio.png)

### 1. Product Detail Gift Promotion List <a href="#id-1" id="id-1"></a>

A screen that looks up and displays the list of gift promotion information present in the detail information for products in the cart list. Clicking the gift area looks up the gift promotion information and calls a modal.<br>

* **Product detail gift promotion list (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%ED%94%84%EB%A1%9C%EB%AA%A8%EC%85%98%20%EC%82%AC%EC%9D%80%ED%96%89%EC%82%AC/getAeEvtList_2))\
  A members-only API that does not apply to non-members.

```
POST/v1/marketing/aeEvtList 
```

***

## Order Eligibility Validation <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/FO%20API_%EC%A3%BC%EB%AC%B8%EA%B0%80%EB%8A%A5%20%EC%9C%A0%ED%9A%A8%EC%84%B1%20%EA%B2%80%EC%82%AC.drawio.png)

### 1. Cart Product Order Validation <a href="#id-1" id="id-1"></a>

Runs validation before entering the order form. On 'success', moves to the order form; on 'failure', shows a failure message.

* **Check whether cart products can be ordered (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=validateBasket))\
  An API that checks whether the selected products can be ordered, when 'Buy Now' or 'Order' is clicked in the cart.

```
POST /v1/basket/validateBasket 
```

***

## Merge Cart <a href="#plus" id="plus"></a>

![](https://tech.x2bee.com/download/attachments/266110356/FO%20API_%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88%20%EB%B3%91%ED%95%A9.drawio.png)

### 1. Merge Cart <a href="#id-1" id="id-1"></a>

When a member logs in, combines the products previously added to the cart as a non-member with the existing member's cart products and displays them.

* **Merge cart (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=combineBsket))\
  Treats the non-member cart data as the most recent data, so the non-member data appears first at the top of the cart when sorted.

```
POST /v1/basket/combineBasket 
```

<br>
