> 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/my-page/order-history/exchange-request.md).

# Exchange Request

## Exchange Request <a href="#plus" id="plus"></a>

Exchanging a purchased product proceeds in the following order: 'Select product to exchange > Select pickup/delivery address > Select exchange reason > Pay any costs incurred by the exchange > Exchange request complete'.

<div 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=""></div>

### 1. View List of Products Eligible for Exchange <a href="#id-1" id="id-1"></a>

Retrieves and displays the target information (order number, product, pickup/delivery address information) for requesting a product exchange.

* **View Exchange Target (FO) (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98\&path=getExchageTargetInfoFO))\
  Both members and non-members use the same order exchange target inquiry (FO) API.

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

### 2. View List of Available Exchange Options <a href="#id-2" id="id-2"></a>

Retrieves the list of exchangeable options for the selected product. If the exchange reason is customer fault, it is shown below the detailed reason.

* **View Item Detail Information by Product (**[🔗View API >](https://api.x2bee.com/content?msa=goods\&depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8\&path=getOrderItmInfos))\
  Both members and non-members use the same item detail information by product (order only) API.

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

### 3. View Payment Method Information <a href="#id-3" id="id-3"></a>

Retrieves and displays the mileage held and available payment methods for the member requesting the exchange.

* **View Claim Additional Payment Information (**[🔗View 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))\
  For non-members, mileage information is not retrieved.

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

### 4. View Costs Incurred by the Exchange <a href="#id-4" id="id-4"></a>

Retrieves and displays the delivery fee amount incurred by the exchange request.

* **View Claim Cost Calculation (**[🔗View 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))\
  Both members and non-members use the same claim cost calculation (FO) API.

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

### 5. Uploading Exchange Reason Images <a href="#id-5" id="id-5"></a>

If the exchange reason is the shopping mall's fault, an image file must be attached and is uploaded to S3.

* **Process Image Upload (**[🔗View 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))\
  Both members and non-members use the same image upload processing API.

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

### 6. Assigning a Delivery Number <a href="#id-6" id="id-6"></a>

Assigns a new delivery number for the exchange request.

* **Process New Delivery Number Assignment (**[🔗View 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))\
  For exchanges, a delivery number is assigned separately for both the pickup address and the delivery address.

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

### 7. Requesting an Exchange <a href="#id-7" id="id-7"></a>

If there is a payment amount due, the exchange request proceeds after PG payment; if there is no payment amount due, the exchange request is completed immediately.

\*If additional delivery fee payment is required due to the exchange request, the merchant information inquiry API is used in common.

* **Accept Exchange (FO) (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98/acceptExchangeFO))\
  Both members and non-members use the same accept exchange (FO) API.

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

### 8. View Exchange Request History <a href="#id-8" id="id-8"></a>

Retrieves and displays detailed information such as the exchanged product, payment history incurred by the exchange, and exchange delivery information.

* **View Claim Detail History (FO)**\
  Both members and non-members use the same claim detail history inquiry API.

```
POST/v1/claim/common/claimDetailsInfoFO 🔗View API >
```

### 9. Canceling an Exchange Request <a href="#id-9" id="id-9"></a>

Withdraws a completed exchange request.

* **Withdraw Exchange Request (FO) (**[🔗View API >](https://api.x2bee.com/content?msa=order\&depth=%EC%A3%BC%EB%AC%B8%EA%B5%90%ED%99%98/withdrawalExchangeFO))

Both members and non-members use the same withdraw exchange request processing (FO) API.

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