> 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/store-front-api/undefined-4/undefined-7.md).

# 선물함

회원간 선물하기 서비스를 이용한 고객은 선물함 페이지에서 받은 선물과 보낸 선물에 대한 정보를 확인할 수 있습니다.

고객은 받은 선물함에서 받은 선물에 대한 배송지 정보를 등록하여 선물을 배송 받을 수 있습니다.

***

## 선물함 조회 및 선물 수령 <a href="#plus" id="plus"></a>

고객이 마이페이지의 선물함을 클릭하면 받은 선물함 목록이 나타납니다. 선물받기를 완료를 위해서는 배송지 입력 버튼을 클릭해 배송지를 등록해야합니다. 선물 받은 상품에 따라 옵션 변경 기능을 제공합니다.

선물함 상단 관련 공지사항을 조회할 수 있습니다. 해당 API는 장바구니 문서의 고객알림리스트 조회를 확인해 주세요.

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266111275/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0%20-%20%EC%84%A0%EB%AC%BC%ED%95%A8%20%EC%A1%B0%ED%9A%8C.drawio.png" alt=""></p>

### 1. 받은 선물 내역 조회하기 <a href="#id-1" id="id-1"></a>

고객이 받은 선물 목록을 조회합니다.

* **받은 선물함 내역 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%84%A0%EB%AC%BC%ED%95%A8\&path=receiveGiftBoxList))\
  회원이 받은 선물 목록을 조회합니다.

```
POST /v1/mypage/giftBox/receiveGiftBoxList 
```

### 2. 선물함 상세 조회하기 <a href="#id-2" id="id-2"></a>

받은 선물에 대한 상세 정보를 확인하는 방법은 다음과 같습니다.

1\) 마이메뉴 > 선물함 > 받은선물함 > 주문번호 클릭

2\) 카카오 알림톡 확인 > 알림톡 선물받기 클릭

고객이 위 경로를 통해 받은 선물에 대한 상세한 정보를 확인 할 수 있으며, 보낸 선물의 상세 정보를 조회하는 화면도 같은 API를 사용합니다.<br>

* **선물함 상세 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%84%A0%EB%AC%BC%ED%95%A8\&path=getGiftDetailInfo))\
  회원이 보내거나 받은 선물의 상세 정보를 조회합니다.

```
POST v1/mypage/giftBox/getGiftDetailInfo 
```

### 3. 선물 받기 <a href="#id-3" id="id-3"></a>

고객이 선물 받은 상품을 수령하기 위해서는 배송지 입력 절차가 필요하며, 배송지 입력 방법은 다음과 같습니다.

1\) 마이메뉴 > 선물함 > 받은선물함 > 주문번호 클릭 > 배송지 입력 절차 진행

2\) 카카오 알림톡 확인 > 알림톡 선물받기 클릭 > 받은 선물 조회 후 배송지 입력 절차 진행

받은 선물의배송지 입력 절차가 완료되면 해당 상품의 배송지가 등록된 배송지로 변경되며, 등록 한 시간으로 배송지시 예약일시로 처리됩니다.<br>

* **선물 수신자 배송지 입력(**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%84%A0%EB%AC%BC%ED%95%A8\&path=registerShippingAddressForReceiveGift))\
  받은 선물의 상태를 수락으로 처리합니다.

```
PUT v1/mypage/giftBox/registerShippingAddress 
```

### 상품 선물하기 <a href="#undefined" id="undefined"></a>

다른 회원에게 상품을 선물하기 위한 주문 방법은 주문/결제 > 주문서 문서의 선물하기 내용을 참고해주세요.