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

# 환불관리

환불을 효율적으로 관리하는 기능을 제공하는 서비스로, 원결제 환불완료 처리, 수기 환불접수 관리, 수기 환불완료 관리 세 가지 기능으로 구성되어 있습니다.

## 주요 기능

* **원결제 환불완료 처리**
  * 회수가 완료된 반품 주문을 조회하여 결제 금액을 환불하고 반품완료 처리를 합니다.
  * 결제 금액 취소 후 반품완료 처리 완료 시, 고객에게 알림을 발송합니다. (이메일/알림톡/알림함)
* **수기 환불접수 관리**
  * 고객센터에서 접수된 환불접수 목록을 조회하고 환불 접수를 취소할 수 있습니다.
* **수기 환불완료 관리**
  * 환불접수 목록을 조회하고 환불 완료 처리를 수행합니다.
  * 환불접수 건의 환불처리결과를 선택하여 환불처리상태(미처리, 성공, 실패)를 변경할 수 있습니다.
  * 성공 처리 시, 환불상태가 환불완료로 변경됩니다.
  * 실패로 처리 시, 환불상태는 변경되지 않습니다.
  * 일괄 환불처리 엑셀 다운로드 기능을 제공하여 환불접수 상태의 환불 건 전체를 엑셀로 다운로드합니다.
* **일괄 환불처리 엑셀 업로드**
  * 엑셀 다운로드를 통해 다운로드 받은 엑셀의 처리 결과를 수정하여 업로드하면 처리결과가 업데이트됩니다.
  * 업로드를 위해서는 사용자가 개인정보를 취급할 수 있어야 하며, ID, 이름, 계좌번호에 대한 개인정보 권한이 필요합니다.

***

## 프로세스 정의 — 원결제 환불완료 관리

반품 회수완료된 주문을 환불완료 처리하는 프로세스

<figure><img src="/files/sLwRfcqI5nIzeIXy31MM" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 원주문 환불완료 처리대상 목록 조회

환불완료 처리대상(반품 회수완료) 목록을 조회합니다.
{% endstep %}

{% step %}

### 원결제 환불완료처리

원결제를 환불 처리하고 환불완료 상태로 주문을 업데이트합니다.
{% endstep %}
{% endstepper %}

***

## 프로세스 정의 — 수기 환불 관리

고객센터에서 접수된 수기 환불 건을 처리하는 프로세스

<figure><img src="/files/MudpGUXhexszTXfdALtB" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 수기 환불내역 조회

수기 환불내역을 조회합니다. 수기 환불접수 관리 화면에선 환불접수 상태의 건만 조회합니다.
{% endstep %}

{% step %}

### 환불접수 취소

환불접수 건을 환불취소 처리합니다.
{% endstep %}

{% step %}

### 환불처리결과 업데이트

환불접수 건에 대한 환불처리결과 상태를 성공 또는 실패로 업데이트합니다.
{% endstep %}

{% step %}

### 수기 환불처리 엑셀 다운로드 권한 체크

수기 환불처리 엑셀 다운로드를 할 수 있는 개인정보 조회 권한이 있는지 체크합니다. 다운로드를 위해 필요한 권한은 ID, 이름, 계좌번호 입니다.
{% endstep %}

{% step %}

### 수기 환불처리 엑셀 다운로드

수기 환불처리 목록을 엑셀로 다운로드 합니다.
{% endstep %}

{% step %}

### 수기 환불처리 엑셀 업로드 업데이트

환불처리 목록 엑셀을 업로드하여 처리결과 상태를 일괄 업데이트합니다.
{% endstep %}
{% endstepper %}

***

## API 기능 목록

<table><thead><tr><th width="144.5555419921875">API</th><th width="288.888916015625">설명</th><th width="92.4444580078125">Server</th><th width="90.22216796875">메소드</th><th>비고</th></tr></thead><tbody><tr><td>원주문 환불완료 처리대상 목록 조회</td><td>환불완료 처리를 할 수 있는 상태의 반품 주문을 조회합니다.</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">🔗API 확인하기 ></a></td></tr><tr><td>원결제 환불완료 처리</td><td>주문금액을 환불하고 환불완료 처리를 합니다.</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">🔗API 확인하기 ></a></td></tr><tr><td>수기 환불내역 조회</td><td>접수된 환불 목록을 조회합니다.</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">🔗API 확인하기 ></a></td></tr><tr><td>환불접수 취소</td><td>환불 중 환불접수된 내역을 취소합니다.</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">🔗API 확인하기 ></a></td></tr><tr><td>환불처리결과 <br>업데이트</td><td>환불처리결과(성공, 실패)를 업데이트 합니다. 성공으로 업데이트 시 환불상태를 환불완료로 업데이트합니다.</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">🔗API 확인하기 ></a></td></tr><tr><td>수기 환불처리 엑셀 다운로드 권한 체크</td><td>엑셀을 다운로드 할 수 있는 권한(ID, 이름, 계좌번호)을 갖고 있는지 체크합니다.</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">🔗API 확인하기 ></a></td></tr><tr><td>수기 환불처리 엑셀 다운로드</td><td>환불처리 대상을 엑셀로 다운로드합니다.</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">🔗API 확인하기 ></a></td></tr><tr><td>수기 환불처리 엑셀 업로드 <br>업데이트</td><td>수기 환불처리 엑셀로 환불처리결과를 업데이트 합니다.</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">🔗API 확인하기 ></a></td></tr></tbody></table>

***