> 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>

***


---

# 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/back-office/payment-bo/undefined-2.md?ask=<question>&goal=<endgoal>
```

`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.