> 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).
# 교환신청
## 교환 신청
구매한 상품 교환은 ‘교환 상품 선택 > 회수지/배송지 선택 > 교환 사유 선택 > 교환 시 발생 비용 결제 > 교환 신청 완료’ 순으로 절차가 진행됩니다.
### 1. 교환가능 상품 목록 조회
상품 교환신청을 위한 대상정보(주문번호, 상품, 회수지/배송지 정보)를 조회하여 나타냅니다.
* **교환대상 조회(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. 교환가능 옵션 목록 조회
선택된 상품의 교환 가능한 옵션 목록을 조회합니다. 교환 사유가 고객귀책인 경우 상세사유 하단에 나타냅니다.
* **상품별 단품정보 조회 (**[🔗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. 결제 수단 정보 조회
교환신청을 진행하는 회원의 보유 마일리지 정보, 사용 가능한 결제수단을 조회하여 나타냅니다.
* **클레임 추가 결제정보 조회 (**[🔗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. 교환 처리 발생 비용 조회
교환신청시 발생하는 배송비 금액 정보를 조회하여 나타냅니다.
* **클레임 비용 계산 조회 (**[🔗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. 교환 사유 이미지 업로드하기
교환 사유가 쇼핑몰 귀책 사유인 경우 필수로 첨부되는 이미지 파일을 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. 배송 번호 채번하기
교환 신청을 위한 신규 배송번호를 채번합니다.
* **배송 번호 채번 처리 (**[🔗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. 교환 신청
결제금액이 있을 경우, 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. 교환 신청 내역 조회
교환 상품, 교환시 발생한 결제 내역, 교환 배송정보 등의 상세 내역 정보를 조회하여 나타냅니다.
* **클레임 상세 내역 조회(FO)**\
비회원과 회원 모두 동일한 클레임 상세 내역 조회 API를 사용합니다.
```
POST/v1/claim/common/claimDetailsInfoFO 🔗API 확인하기 >
```
### 9. 교환 신청 취소하기
교환신청 완료 건을 철회처리 합니다.
* **교환접수철회(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
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://tech.x2bee.com/api-guide/store-front-api/undefined-4/undefined-8/undefined-3.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.