> 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-8/undefined-3.md).

# 교환신청

## 교환 신청 <a href="#plus" id="plus"></a>

구매한 상품 교환은 ‘교환 상품 선택 > 회수지/배송지 선택 > 교환 사유 선택 > 교환 시 발생 비용 결제 > 교환 신청 완료’ 순으로 절차가 진행됩니다.

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266111523/%EA%B5%90%ED%99%98%EC%8B%A0%EC%B2%AD.drawio.png" alt=""></p>

### 1. 교환가능 상품 목록 조회 <a href="#id-1" id="id-1"></a>

상품 교환신청을 위한 대상정보(주문번호, 상품, 회수지/배송지 정보)를 조회하여 나타냅니다.

* **교환대상 조회(FO) (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98\&path=getExchageTargetInfoFO))\
  비회원과 회원 모두 동일한 주문교환대상 조회(FO) API를 사용합니다.

```
POST/v1/claim/exchange/getExchageTargetInfoFO 
```

### 2. 교환가능 옵션 목록 조회 <a href="#id-2" id="id-2"></a>

선택된 상품의 교환 가능한 옵션 목록을 조회합니다. 교환 사유가 고객귀책인 경우 상세사유 하단에 나타냅니다.

* **상품별 단품정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8\&path=getOrderItmInfos))\
  비회원과 회원 모두 동일한 상품별 단품정보 조회(주문전용) API를 사용합니다.

```
POST /v1/detail/otherItms 
```

### 3. 결제 수단 정보 조회 <a href="#id-3" id="id-3"></a>

교환신청을 진행하는 회원의 보유 마일리지 정보, 사용 가능한 결제수단을 조회하여 나타냅니다.

* **클레임 추가 결제정보 조회 (**[🔗API 확인하기 >](https://api-order.x2bee.com/api/order/swagger-ui/index.html#/%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5/getAdditionalFeePaymentInfo))\
  비회원의 경우 마일리지 정보는 조회되지 않습니다.

```
POST /v1/claim/common/additionalFeePaymentInfo 
```

### 4. 교환 처리 발생 비용 조회 <a href="#id-4" id="id-4"></a>

교환신청시 발생하는 배송비 금액 정보를 조회하여 나타냅니다.

* **클레임 비용 계산 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5/calculateFO))\
  비회원과 회원 모두 동일한 클레임 비용 계산 조회(FO) API를 사용합니다.

```
POST /v1/claim/common/claimCalculateCostFO 
```

### 5. 교환 사유 이미지 업로드하기 <a href="#id-5" id="id-5"></a>

교환 사유가 쇼핑몰 귀책 사유인 경우 필수로 첨부되는 이미지 파일을 S3에 업로드 합니다.

* **이미지 업로드 처리 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5/claimImgUpload))\
  비회원과 회원 모두 동일한 이미지 업로드 처리 API를 사용합니다.

```
POST /v1/claim/common/claimImgUpload 
```

### 6. 배송 번호 채번하기 <a href="#id-6" id="id-6"></a>

교환 신청을 위한 신규 배송번호를 채번합니다.

* **배송 번호 채번 처리 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5/getNewNumberedDeliNo))\
  교환의 경우 회수지, 배송지 각각에 대해 배송번호를 채번합니다.

```
POST/v1/claim/common/getNewNumberedDeliNo 
```

### 7. 교환 신청 <a href="#id-7" id="id-7"></a>

결제금액이 있을 경우, PG 결제 후 교환 신청이 진행되고, 결제금액이 없을 경우 바로 교환이 신청이 완료됩니다.

\*교환신청에 따른 추가 배송비 결제가 필요한 경우, 가맹점 정보 조회 API를 공통으로 사용합니다.

* **교환접수(FO) (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98/acceptExchangeFO))\
  비회원과 회원 모두 동일한 교환접수(FO) API를 사용합니다.

```
POST/v1/claim/exchange/acceptExchangeFO 
```

### 8. 교환 신청 내역 조회 <a href="#id-8" id="id-8"></a>

교환 상품, 교환시 발생한 결제 내역, 교환 배송정보 등의 상세 내역 정보를 조회하여 나타냅니다.

* **클레임 상세 내역 조회(FO)**\
  비회원과 회원 모두 동일한 클레임 상세 내역 조회 API를 사용합니다.

```
POST/v1/claim/common/claimDetailsInfoFO 🔗API 확인하기 >
```

### 9. 교환 신청 취소하기 <a href="#id-9" id="id-9"></a>

교환신청 완료 건을 철회처리 합니다.

* **교환접수철회(FO) (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98/withdrawalExchangeFO))

비회원과 회원 모두 동일한 교환접수철회 처리(FO) API를 사용합니다.

```
POST/v1/claim/exchange/withdrawalExchangeFO 
```