> 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/back-office/payment-bo/refund-management.md).

# Refund Management

A service that provides functionality for efficiently managing refunds, consisting of three features: original payment refund completion processing, manual refund request management, and manual refund completion management.

## Key Features

* **Original Payment Refund Completion Processing**
  * Looks up return orders that have completed collection, refunds the payment amount, and processes the return as complete.
  * After canceling the payment amount and completing return processing, sends a notification to the customer. (email/AlimTalk/notification box)
* **Manual Refund Request Management**
  * Looks up the list of refund requests received at the customer center and can cancel refund requests.
* **Manual Refund Completion Management**
  * Looks up the list of refund requests and performs refund completion processing.
  * You can select the refund processing result for a refund request case to change the refund processing status (not processed, success, failure).
  * When processed as success, the refund status changes to refund complete.
  * When processed as failure, the refund status does not change.
  * Provides a bulk refund processing Excel download feature that downloads all refund cases in refund-requested status as an Excel file.
* **Bulk Refund Processing Excel Upload**
  * When you modify and upload the processing results in the Excel file downloaded via Excel download, the processing results are updated.
  * To upload, the user must be authorized to handle personal information, and requires personal information permissions for ID, name, and account number.

***

## Process Definition — Original Payment Refund Completion Management

The process of completing refund processing for orders whose returns have completed collection

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FZ5ztIpT9Ep5D0DyeCKqA%2F%E1%84%8B%E1%85%AF%E1%86%AB%E1%84%80%E1%85%A7%E1%86%AF%E1%84%8C%E1%85%A6.png?alt=media&#x26;token=486fe09e-904d-4639-91f5-b67fa1037a4e" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Lookup List of Original Order Refund Completion Processing Targets

Looks up the list of refund completion processing targets (returns with collection completed).
{% endstep %}

{% step %}

### Original Payment Refund Completion Processing

Processes the refund for the original payment and updates the order to refund-completed status.
{% endstep %}
{% endstepper %}

***

## Process Definition — Manual Refund Management

The process for handling manual refund cases received at the customer center

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2Fq3qJOyaRDBOqRyib1x46%2F%E1%84%89%E1%85%AE%E1%84%80%E1%85%B5.png?alt=media&#x26;token=03016805-532f-4af3-ae7a-f1d808695ae2" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Manual Refund History Lookup

Looks up manual refund history. In the Manual Refund Request Management screen, only cases in refund-requested status are looked up.
{% endstep %}

{% step %}

### Cancel Refund Request

Processes a refund request case as refund-canceled.
{% endstep %}

{% step %}

### Update Refund Processing Result

Updates the refund processing result status for a refund request case to success or failure.
{% endstep %}

{% step %}

### Check Permission for Manual Refund Processing Excel Download

Checks whether the user has the personal information lookup permission required to download the manual refund processing Excel file. The permissions required for download are ID, name, and account number.
{% endstep %}

{% step %}

### Manual Refund Processing Excel Download

Downloads the manual refund processing list as an Excel file.
{% endstep %}

{% step %}

### Manual Refund Processing Excel Upload Update

Uploads the refund processing list Excel file to bulk-update the processing result status.
{% endstep %}
{% endstepper %}

***

## API Function List

<table><thead><tr><th width="144.5555419921875">API</th><th width="288.888916015625">Description</th><th width="92.4444580078125">Server</th><th width="90.22216796875">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Lookup List of Original Order Refund Completion Processing Targets</td><td>Looks up return orders that are in a status eligible for refund completion processing.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=payment&#x26;depth=%ED%99%98%EB%B6%88%EA%B4%80%EB%A6%AC&#x26;path=getRefundBundleApproMgmtList">🔗View API ></a></td></tr><tr><td>Original Payment Refund Completion Processing</td><td>Refunds the order amount and processes it as refund complete.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=payment&#x26;depth=%ED%99%98%EB%B6%88%EA%B4%80%EB%A6%AC&#x26;path=saveRefundBundleApproMgmtList">🔗View API ></a></td></tr><tr><td>Manual Refund History Lookup</td><td>Looks up the list of received refund requests.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=payment&#x26;depth=%ED%99%98%EB%B6%88%EA%B4%80%EB%A6%AC&#x26;path=getRefundAcceptMgmtList">🔗View API ></a></td></tr><tr><td>Cancel Refund Request</td><td>Cancels a refund-requested case that is under refund processing.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=payment&#x26;depth=%ED%99%98%EB%B6%88%EA%B4%80%EB%A6%AC&#x26;path=cancelRefundAccept">🔗View API ></a></td></tr><tr><td>Update Refund<br>Processing Result</td><td>Updates the refund processing result (success, failure). When updated as success, the refund status is updated to refund complete.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=payment&#x26;depth=%ED%99%98%EB%B6%88%EA%B4%80%EB%A6%AC&#x26;path=saveRefundProcRslt">🔗View API ></a></td></tr><tr><td>Check Permission for Manual Refund Processing Excel Download</td><td>Checks whether the user has permission (ID, name, account number) to download the Excel file.</td><td>BO</td><td>GET</td><td><a href="http://apibo.x2bee.com/content?bo=payment&#x26;depth=%ED%99%98%EB%B6%88%EA%B4%80%EB%A6%AC&#x26;path=hasRefundExcelDownloadPermission">🔗View API ></a></td></tr><tr><td>Manual Refund Processing Excel Download</td><td>Downloads the refund processing targets as an Excel file.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=payment&#x26;depth=%ED%99%98%EB%B6%88%EA%B4%80%EB%A6%AC&#x26;path=getRefundExcelData">🔗View API ></a></td></tr><tr><td>Manual Refund Processing Excel Upload<br>Update</td><td>Updates the refund processing result using the manual refund processing Excel file.</td><td>BO</td><td>POST</td><td><a href="http://apibo.x2bee.com/content?bo=payment&#x26;depth=%ED%99%98%EB%B6%88%EA%B4%80%EB%A6%AC&#x26;path=refundExcelUpload">🔗View API ></a></td></tr></tbody></table>

***