> 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/store-front-api/order-api/undefined-6.md).

# 환불

## 원결제 환불 완료

> \## 기능 설명\
> \* BO에서 원결제 환불 완료 처리합니다.\
> \---\
> \## 상세 설명\
> \* \*\*주문 번호(ordNo)\*\*, \*\*클레임번호(claimNo)\*\*, \*\*클레임업무유형(claimBusinessType)\*\*, \*\*시스템유형(systemType)\*\*은 필수로 있어야합니다.\
> \* 대상 클레임을 반품완료처리합니다.\
> &#x20;   \* \*\*반품완료처리 설명\*\*\
> &#x20;       \* 주문내역구분(OM003) 값이 \*\*반품(20)\*\* 이고, 주문내역상태(OM005) 값이 \*\*회수완료(36)\*\* 상태인 경우 처리 가능합니다.\
> &#x20;       \* API 호출 시점의 주문 상태를 재 확인, 완료 처리 가능 여부를 확인합니다.\
> &#x20;       \* 주문상세 테이블의 주문내역상태코드(OM005) 값이 반품완료(37) 상태로 변경되며(사은품 포함), 주문완료일시(ordFnshDtm)를 업데이트합니다.\
> &#x20;       \* 주문배송정보 테이블의 배송완료일시(deliFnshDtm)를 업데이트합니다.\
> &#x20;       \* 주문시 사용되었던 쿠폰과 주문상품(사은품 포함)의 재고가 복원됩니다. 단, 주문상세의 교환중반품여부(exchMidRtnYn)값이 (Y)인 경우 재고 복원대상에서 제외됩니다.\
> &#x20;       \* 환불 절차를 진행합니다.\
> &#x20;       \* 반품 완료 처리 후 고객에게 알림을 발송합니다.(이메일/알림톡/알림함)\
> &#x20;       \* 반품 완료 처리 후 처리 이력을 생성합니다.\
> \* 대상 클레임들을 모두 환불 완료 후 결과를 전달합니다.\
> \---\
> \## 특이 사항\
> \* \*\*클레임업무유형(claimBusinessType)\*\*이 \*\*반품완료(22)\*\*인 경우에 원결제 환불 완료 처리합니다.<br>

```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"}}}}
```

## 환불접수 등록

> \## 기능 설명\
> \* 고객센터에서 고객 보상(현금) 요청 시 환불 정보 테이블에 등록합니다.\
> \---\
> \## 상세 설명\
> \* 요청한 고객 보상 정보를 환불 정보 테이블에 등록합니다.\
> \* 테이블에 정보 등록이 성공하면 환불번호를 반환합니다.<br>

```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"}}}}
```