# 환불
## 원결제 환불 완료
> \## 기능 설명\
> \* BO에서 원결제 환불 완료 처리합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임번호(claimNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 대상 클레임을 반품완료처리합니다.\
> \* \*\*반품완료처리 설명\*\*\
> \* 주문내역구분(OM003) 값이 \*\*반품(20)\*\* 이고, 주문내역상태(OM005) 값이 \*\*회수완료(36)\*\* 상태인 경우 처리 가능합니다.\
> \* API 호출 시점의 주문 상태를 재 확인, 완료 처리 가능 여부를 확인합니다.\
> \* 주문상세 테이블의 주문내역상태코드(OM005) 값이 반품완료(37) 상태로 변경되며(사은품 포함), 주문완료일시(ordFnshDtm)를 업데이트합니다.\
> \* 주문배송정보 테이블의 배송완료일시(deliFnshDtm)를 업데이트합니다.\
> \* 주문시 사용되었던 쿠폰과 주문상품(사은품 포함)의 재고가 복원됩니다. 단, 주문상세의 교환중반품여부(exchMidRtnYn)값이 (Y)인 경우 재고 복원대상에서 제외됩니다.\
> \* 환불 절차를 진행합니다.\
> \* 반품 완료 처리 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\
> \* 반품 완료 처리 후 처리 이력을 생성합니다.\
> \* 대상 클레임들을 모두 환불 완료 후 결과를 전달합니다.\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*반품완료(22)\*\*인 경우에 원결제 환불 완료 처리합니다.
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/payment/saveRefundBundleApproMgmt":{"post":{"tags":["환불"],"summary":"원결제 환불 완료","description":"## 기능 설명\n* BO에서 원결제 환불 완료 처리합니다.\n---\n## 상세 설명\n* **주문 번호(ordNo)**, **클레임번호(claimNo)**, **클레임업무유형(claimBusinessType)**, **시스템유형(systemType)**은 필수로 있어야합니다.\n* 대상 클레임을 반품완료처리합니다.\n * **반품완료처리 설명**\n * 주문내역구분(OM003) 값이 **반품(20)** 이고, 주문내역상태(OM005) 값이 **회수완료(36)** 상태인 경우 처리 가능합니다.\n * API 호출 시점의 주문 상태를 재 확인, 완료 처리 가능 여부를 확인합니다.\n * 주문상세 테이블의 주문내역상태코드(OM005) 값이 반품완료(37) 상태로 변경되며(사은품 포함), 주문완료일시(ordFnshDtm)를 업데이트합니다.\n * 주문배송정보 테이블의 배송완료일시(deliFnshDtm)를 업데이트합니다.\n * 주문시 사용되었던 쿠폰과 주문상품(사은품 포함)의 재고가 복원됩니다. 단, 주문상세의 교환중반품여부(exchMidRtnYn)값이 (Y)인 경우 재고 복원대상에서 제외됩니다.\n * 환불 절차를 진행합니다.\n * 반품 완료 처리 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\n * 반품 완료 처리 후 처리 이력을 생성합니다.\n* 대상 클레임들을 모두 환불 완료 후 결과를 전달합니다.\n---\n## 특이 사항\n* **클레임업무유형(claimBusinessType)**이 **반품완료(22)**인 경우에 원결제 환불 완료 처리합니다.\n","operationId":"saveRefundBundleAppro","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RefundBundleApproMgmtCUDSaveRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RefundBundleApproMgmtCUDResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RefundBundleApproMgmtCUDSaveRequest":{"required":["claimBusinessType","ordMediaCd","ordNo","systemType"],"type":"object","properties":{"claimBusinessType":{"type":"string","description":" ClaimBusiness(클레임업무유형)\n * 11 : 주문취소\n * 20 : 반품접수\n * 21 : 반품취소\n * 30 : 교환접수\n * 31 : 교환취소\n * 22 : 반품완료\n * 23 : 반품불가\n * 24 : 교환반품\n * 25 : 반품보류\n","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM","RETURN_PENDING","DELIVERY_FEE_PAYMENT"],"default":"20"},"ordNo":{"type":"string","description":"주문번호"},"ordMediaCd":{"type":"string","description":"주문매체 코드(OM007)\n 10 : 전화상담(CC)\n, 20 : PC\n, 30 : 모바일웹\n, 40 : 안드로이드앱\n, 50 : IOS앱\n, 60 : 정기주문\n","enum":["10","20","30","40","50","60"],"default":"20"},"systemType":{"type":"string","description":" SYSTEM(시스템유형)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"],"default":"20"},"claimNo":{"type":"string","description":"클레임번호"}},"description":"원주문 환불완료처리 요청 DTO"},"RefundBundleApproMgmtCUDResponse":{"type":"object","properties":{"claimNo":{"type":"string","description":"클레임번호"},"resultCode":{"type":"string","description":"결과코드"}},"description":"원주문 환불완료처리 결과 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 환불접수 등록
> \## 기능 설명\
> \* 고객센터에서 고객 보상(현금) 요청 시 환불 정보 테이블에 등록합니다.\
> \---\
> \## 상세 설명\
> \* 요청한 고객 보상 정보를 환불 정보 테이블에 등록합니다.\
> \* 테이블에 정보 등록이 성공하면 환불번호를 반환합니다.
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/payment/refundAcceptRegister":{"post":{"tags":["환불"],"summary":"환불접수 등록","description":"## 기능 설명\n* 고객센터에서 고객 보상(현금) 요청 시 환불 정보 테이블에 등록합니다.\n---\n## 상세 설명\n* 요청한 고객 보상 정보를 환불 정보 테이블에 등록합니다.\n* 테이블에 정보 등록이 성공하면 환불번호를 반환합니다.\n","operationId":"refundAcceptRegister","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundAcceptRegisterRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RefundAcceptRegisterResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RefundAcceptRegisterRequest":{"required":["acptmnId","loginId","mbrNm","mbrNo","rfdActnCertiYn","rfdActnDepositorNm","rfdActnNo","rfdAmt","rfdBankCd","rfdCausCd","rfdCmsnAmt","rfdPrgsStatCd","rfdSmsSndYn","rfdTypCd"],"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"rfdTypCd":{"type":"string","description":"환불유형코드(OM023)"},"rfdPrgsStatCd":{"type":"string","description":"환불진행상태코드(OM024)"},"rfdBankCd":{"type":"string","description":"환불은행코드(OM026)"},"rfdActnNo":{"type":"string","description":"환불계좌번호"},"rfdActnDepositorNm":{"type":"string","description":"환불예금주"},"rfdCausCd":{"type":"string","description":"환불사유코드(OM025)"},"rfdActnCertiYn":{"type":"string","description":"환불계좌인증여부"},"rfdAmt":{"type":"integer","description":"환불금액","format":"int64"},"rfdCmsnAmt":{"type":"integer","description":"환불수수료금액","format":"int64"},"acptmnId":{"type":"string","description":"접수자ID"},"rfdSmsSndYn":{"type":"string","description":"환불SMS발송여부"}},"description":"환불접수등록 Request DTO"},"RefundAcceptRegisterResponse":{"type":"object","properties":{"rfdNo":{"type":"string"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
---
# Agent Instructions: 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:
```
GET https://tech.x2bee.com/api/store-front-api/order-api/undefined-6.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.