장바구니

사용자가 제품을 선택하고 장바구니에 담는 기능을 관리하고, 주문 프로세스를 시작하기 위한 필수 요소입니다.

사용자는 선택한 제품을 장바구니에 추가, 수정, 삭제하며 주문할 제품을 관리할 수 있도록 API를 제공합니다.

PC

Mobile

---

장바구니 조회 영역

1. 장바구니 조회

장바구니 담기로 선택한 상품들의 목록을 조회합니다.

1) 회원 : 회원번호로 장바구니를 조회합니다.

2) 비회원 : 비회원은 장바구니 최초 등록 시 세션번호가 생성되어 쿠키에 저장되며, 이후 세션번호를 쿠키에서 가져와 조회합니다.

• 장바구니 조회 (🔗API 확인하기 >) 회원번호 및 비회원의 쿠키 세션번호로 조회하여 구성 정보를 출력합니다.

GET /v1/basket/getBasket

2. 고객알림리스트 조회

BO 시스템의 공지사항 관리 > 고객 알림 관리에 등록하여 나타나는 상단 공지사항을 조회합니다.​

• 화면 고객알림 조회 (🔗API 확인하기 >) 고객알림리스트를 조회합니다.

GET /v1/common/getContsList 

3. 무이자 할부 안내 목록 조회

장바구니 하단 텍스트를 클릭 시, 무이자할부 안내 관리에 등록된 행사 정보를 호출하여 나타냅니다.

• 무이자 할부 안내 목록 조회 (🔗API 확인하기 >) 신용카등의 무이자할부 안내 목록을 조회합니다.

GET /v1/payment/getInterestFreeList  

---

장바구니 삭제

1. 장바구니 삭제

품절 상품 혹은 선택된 상품을 장바구니 목록 화면에서 삭제 합니다.

• 장바구니 삭제 (🔗API 확인하기 >) 장바구니 상품 목록에서 선택된 상품을 삭제 합니다.

PUT /v1/basket/deleteBasket 

---

장바구니 옵션변경

1. 장바구니 옵션변경

장바구니에서 대상 상품을 선택하여 ‘옵션변경’을 클릭하면, 변경 옵션을 옵션 및 수량 변경 팝업이 나타납니다. 수량을 변경하고 [선택완료]를 클릭하면, 변경된 수량으로 저장됩니다.

• 장바구니 옵션변경 (🔗API 확인하기 >) ‘선택완료’ 버튼 클릭 시, 장바구니 상품옵션 변경 API를 호출합니다.

PUT /v1/basket/optionChange 

---

상품상세 사은행사 목록

1. 상품상세 사은행사 목록

장바구니 목록의 상품 중에서 상세정보에 존재하는 사은행사 정보 리스트를 조회하여 출력하는 화면입니다.사은품 영역 클릭 시 사은행사 정보를 조회하여 모달을 호출합니다.

• 상품상세 사은행사 목록 (🔗API 확인하기 >) 비회원은 해당 사항이 없는 회원 전용 API 입니다.

POST/v1/marketing/aeEvtList 

---

주문가능 유효성 검사

1. 장바구니 상품주문 유효성 검사

주문서 진입 전 유효성 검사를 진행합니다. 유효성 검사 ‘성공 시’ 주문서로 이동하며, ‘실패 시’ 실패 메시지를 노출 합니다.

• 장바구니 상품 주문가능여부 체크 (🔗API 확인하기 >) 장바구니에서 ‘바로구매’ 또는 ‘주문하기’ 클릭 시, 선택한 상품의 주문가능 여부를 검사하는 API 입니다.

POST /v1/basket/validateBasket 

---

장바구니 병합

1. 장바구니 병합

비회원으로 담았던 장바구니 상품들을 회원 로그인 시 기존 회원의 장바구니 상품과 결합하여 나타냅니다.

• 장바구니 병합 (🔗API 확인하기 >) 비회원 장바구니 데이터를 최신 데이터로 간주하여 정렬 시에 장바구니 상단에 비회원 데이터가 먼저 나타납니다.

POST /v1/basket/combineBasket