> 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/order/order-return.md).

# Order Return

Through return and return cancellation features for ordered products, customers can conveniently return products whenever they want, and cancel the return if needed. Both members and non-members can access this via order information and login information, and information such as the return product, quantity, pickup address, and reason is provided to support accurate and prompt return processing.

***

## Key Features

* **Return and Return Cancellation Features**
  * Provides return request and cancellation features via the order list or order detail page.
  * Provides the information required for the return request so customers can enter the necessary information.
* **Information Provision and Validation**
  * Based on information such as the return product, quantity, pickup address, and reason, available coupons, costs, and benefits are recalculated and validated.
* **Return Request/Cancellation Processing**
  * When submitting a return request, additional delivery fee payment, coupon usage, notification sending, and other processing are possible.
  * When cancelling a return, refunding the paid cost, restoring coupons, sending notifications, and other processing are possible.
  * A notification is sent after the return cancellation is completed to inform the customer of the status.

## Process Definition - Return Request

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FWzKAbwZh0KpzDALDGAeA%2F%E1%84%8C%E1%85%AE%E1%84%86%E1%85%AE%E1%86%AB%E1%84%87%E1%85%A1%E1%86%AB%E1%84%91%E1%85%AE%E1%86%B7.png?alt=media&#x26;token=e5424910-5dc4-44b0-bfae-668be5636355" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Return Request Target Lookup

Users can submit a return request via the order list or order detail page. The list of return-eligible products among the ordered products is retrieved and displayed in the return request popup.
{% endstep %}

{% step %}

### Claim Cost Calculation Lookup

After the user selects a product, quantity, pickup address, and reason, the expected refund/payment amount is calculated based on that information.
{% endstep %}

{% step %}

### Claim Additional Payment Information Lookup

If the claim cost calculation result shows an additional amount to pay, retrieves the list of available payment methods, and for members, their held mileage information.
{% endstep %}

{% step %}

### Delivery Number Issuance Processing

Issues a new delivery number for the pickup address to be used for the return request.
{% endstep %}

{% step %}

### Image Upload Processing

Uploads the attached reason image.
{% endstep %}

{% step %}

### Return Request

Processes the return request for the selected product.
{% endstep %}

{% step %}

### Return Completion Batch

Once the return-requested product is finally retrieved, the request is marked as complete. Upon return completion processing, the ordered product's stock is restored, and the payment amount, minus the cost incurred at the time of the return request, is refunded.\
A notification is sent to the customer after the return is completed.
{% endstep %}
{% endstepper %}

## Process Definition - Return Cancellation

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2F5oLUNB2jfhcCZ6V96zz0%2F%E1%84%87%E1%85%A1%E1%86%AB%E1%84%91%E1%85%AE%E1%86%B7%E1%84%8E%E1%85%B1%E1%84%89%E1%85%A9.png?alt=media&#x26;token=41d9cb85-43f2-481e-931a-a84fac1de965" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Claim Detail Lookup

Retrieves the return request history. Provides the return progress status, refund/payment history, coupons pending refund, and pickup address information.
{% endstep %}

{% step %}

### Return Withdrawal

Users open the return detail popup via the order list or order detail page. The Cancel Return button appears for return requests eligible for withdrawal, and clicking the Cancel Return button processes the cancellation of that return.
{% endstep %}
{% endstepper %}

## Process Definition - Delivery Fee Payment

If an additional payment cost arises when a return is requested via the customer center, the request status is marked as “Payment Pending,” and the customer proceeds with payment directly via the delivery fee payment popup.

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FyOrDKYLwdPHXa4OdaHvP%2F%E1%84%87%E1%85%A2%E1%84%89%E1%85%A9%E1%86%BC%E1%84%87%E1%85%B5%20%E1%84%80%E1%85%A7%E1%86%AF%E1%84%8C%E1%85%A6%20(1).png?alt=media&#x26;token=a9fadcee-5b49-4a35-ba0d-e04c2971eae5" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Claim Delivery Fee Payment-Pending Status Target Information

Retrieves the additional payment amount and payment method information, and additionally retrieves the held mileage information for members. For return requests, an initial delivery fee or pickup delivery fee may be incurred.
{% endstep %}

{% step %}

### Return Withdrawal

Requests payment using the selected payment method.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="100.111083984375">API</th><th width="424.3333740234375">Description</th><th width="92.4444580078125">Server</th><th width="92.4444580078125">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Return Request Target Lookup(FO)</td><td>Retrieves all return-eligible products among the ordered products.<br>Retrieves the order information and common codes needed to process a return request.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=returnTargetInfoFO">🔗View API ></a></td></tr><tr><td>Return Request(FO)</td><td>Processes the return request for the selected product.<br>Recalculates and validates the cost and benefits based on the product / quantity / pickup address / return reason / coupon usage selected by the customer.<br>Requests payment if an additional amount arises during the return process. When a free return coupon is used, the pickup delivery fee is excluded and the coupon is marked as used.<br>A notification is sent to the customer after the return request is completed.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=acceptReturnFO">🔗View API ></a></td></tr><tr><td>Return Withdrawal(FO)</td><td>Withdraws the return request.<br>Refunds the cost paid at the time of the return request.<br>If a free return coupon was used at the time of the return request, it is restored.<br>A notification is sent to the customer after the return withdrawal is completed.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%EC%A3%BC%EB%AC%B8%EB%B0%98%ED%92%88&#x26;path=withdrawalReturnFO">🔗View API ></a></td></tr><tr><td>Claim Cost Calculation Lookup</td><td>Retrieves the additional cost, benefits, additional payment or pending refund information, and available coupon information incurred during return.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=calculateFO">🔗View API ></a></td></tr><tr><td>Delivery Number Issuance Processing</td><td>Generates a new delivery number for the return pickup address.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=getNewNumberedDeliNo">🔗View API ></a></td></tr><tr><td>Image Upload Processing</td><td>Uploads the attached image according to the return responsible party reason.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=claimImgUpload">🔗View API ></a></td></tr><tr><td>Claim Additional Payment Information Lookup</td><td>If an additional payment amount arises at the time of the return request, retrieves the payment method and mileage information.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=getAdditionalFeePaymentInfo">🔗View API ></a></td></tr><tr><td>Claim Delivery Fee Payment-Pending Status Target Information</td><td>Retrieves the additional payment amount and payment method information for returns in Payment Pending status.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=getClaimPayWaitStateInfo">🔗View API ></a></td></tr><tr><td>Claim Delivery Fee Payment Processing</td><td>Requests payment for the additional cost (initial delivery fee, pickup delivery fee) incurred at the time of the return request.</td><td>Order</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=order&#x26;depth=%ED%81%B4%EB%A0%88%EC%9E%84%EA%B3%B5%ED%86%B5&#x26;path=doPayDeliveryFee">🔗View API ></a></td></tr></tbody></table>

## Terminology

<table><thead><tr><th width="110.111083984375">Term</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Initial Delivery Fee</td><td>A delivery fee charged when, at the time of a return request, the previously applied conditional free-delivery-fee benefit no longer meets the condition due to the return. It is charged per delivery group and does not occur for exchanges.</td><td></td></tr><tr><td>Additional Delivery Fee</td><td>Refers to the delivery fee charged for a remote island/mountainous delivery address as stated in the delivery policy.</td><td></td></tr></tbody></table>

## Other Notes

* Return requests can only be submitted within the same delivery group.
* When submitting or cancelling a return request, the processable order history status and order history classification values are checked. This information is managed via a common code.
  * ST007 (FO System Claim-Processable Status) reference value 1 = order history status code
  * ST007 (FO System Claim-Processable Status) reference value 2 = order history classification code
* When looking up return targets, the product attribute “Return Eligible” value is checked.
* Return reasons are managed via a common code, and include information such as the responsible party classification, target order history classification, and whether it is exposed in FO, for each reason.
* For products with a gift item, partial-quantity return is not possible.
* If a payment method that does not support partial cancellation was used at the time of order, only a full order return is possible.
* If there is already a return application history within the same delivery group for which the initial delivery fee has been incurred, and that return is in a cancellable state, an additional return request cannot be submitted.
* When submitting a return request that incurs an initial delivery fee, if there is a cancellable return history within the same delivery group, an additional return request cannot be submitted.
* When cancelling a return request in the Pickup Instructed status, the delivery instruction cancellation quantity is updated.