> 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/api-en/store-front-api-reference/order-api/refund.md).
# Refund
## Complete Original Payment Refund
> \## Function Description\
> \* Processes completion of the original payment refund in BO.\
> \---\
> \## Detailed Description\
> \* \*\*Order No. (ordNo)\*\*, \*\*Claim No. (claimNo)\*\*, \*\*Claim Business Type (claimBusinessType)\*\*, and \*\*System Type (systemType)\*\* are required.\
> \* Processes the target claim as return-completed.\
> \* \*\*Return-completion processing description\*\*\
> \* Can be processed if the order history type (OM003) value is \*\*Return (20)\*\* and the order history status (OM005) value is \*\*Collection Completed (36)\*\*.\
> \* Re-checks the order status at the time of the API call and verifies whether completion is possible.\
> \* The order detail table's order history status code (OM005) value is changed to Return Completed (37) (including gift), and the order completion datetime (ordFnshDtm) is updated.\
> \* The order delivery information table's delivery completion datetime (deliFnshDtm) is updated.\
> \* The stock of the coupon used at order time and the order product (including gift) is restored. However, if the order detail's exchange-in-progress-return status (exchMidRtnYn) value is (Y), it is excluded from stock restoration.\
> \* The refund process is carried out.\
> \* A notification is sent to the customer after return completion processing (email/notification message/notification inbox).\
> \* A processing history is created after return completion processing.\
> \* Delivers the result after all target claims have been fully refunded.\
> \---\
> \## Notes\
> \* Processes the original payment refund completion when \*\*Claim Business Type (claimBusinessType)\*\* is \*\*Return Completed (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":["Refund"],"summary":"Complete Original Payment Refund","description":"## Function Description\n* Processes completion of the original payment refund in BO.\n---\n## Detailed Description\n* **Order No. (ordNo)**, **Claim No. (claimNo)**, **Claim Business Type (claimBusinessType)**, and **System Type (systemType)** are required.\n* Processes the target claim as return-completed.\n * **Return-completion processing description**\n * Can be processed if the order history type (OM003) value is **Return (20)** and the order history status (OM005) value is **Collection Completed (36)**.\n * Re-checks the order status at the time of the API call and verifies whether completion is possible.\n * The order detail table's order history status code (OM005) value is changed to Return Completed (37) (including gift), and the order completion datetime (ordFnshDtm) is updated.\n * The order delivery information table's delivery completion datetime (deliFnshDtm) is updated.\n * The stock of the coupon used at order time and the order product (including gift) is restored. However, if the order detail's exchange-in-progress-return status (exchMidRtnYn) value is (Y), it is excluded from stock restoration.\n * The refund process is carried out.\n * A notification is sent to the customer after return completion processing (email/notification message/notification inbox).\n * A processing history is created after return completion processing.\n* Delivers the result after all target claims have been fully refunded.\n---\n## Notes\n* Processes the original payment refund completion when **Claim Business Type (claimBusinessType)** is **Return Completed (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":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RefundBundleApproMgmtCUDResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RefundBundleApproMgmtCUDSaveRequest":{"required":["claimBusinessType","ordMediaCd","ordNo","systemType"],"type":"object","properties":{"claimBusinessType":{"type":"string","description":" ClaimBusiness (Claim Business Type)\n * 11 : Order Cancellation\n * 20 : Return Receipt\n * 21 : Return Cancellation\n * 30 : Exchange Receipt\n * 31 : Exchange Cancellation\n * 22 : Return Completed\n * 23 : Return Not Possible\n * 24 : Exchange Return\n * 25 : Return On Hold\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":"Order No."},"ordMediaCd":{"type":"string","description":"Order Channel Code (OM007)\n 10 : Phone Consultation (CC)\n, 20 : PC\n, 30 : Mobile Web\n, 40 : Android App\n, 50 : iOS App\n, 60 : Subscription Order\n","enum":["10","20","30","40","50","60"],"default":"20"},"systemType":{"type":"string","description":" SYSTEM (System Type)\n * 10 : FO\n * 20 : BO\n","enum":["FO","BO"],"default":"20"},"claimNo":{"type":"string","description":"Claim No."}},"description":"Original Order Refund Completion Processing Request DTO"},"RefundBundleApproMgmtCUDResponse":{"type":"object","properties":{"claimNo":{"type":"string","description":"Claim No."},"resultCode":{"type":"string","description":"Result Code"}},"description":"Original Order Refund Completion Processing Result 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"}}}}
```
## Register Refund Receipt
> \## Function Description\
> \* Registers a customer compensation (cash) request from the customer center into the refund information table.\
> \---\
> \## Detailed Description\
> \* Registers the requested customer compensation information into the refund information table.\
> \* Returns a refund number if the information is successfully registered in the table.
```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":["Refund"],"summary":"Register Refund Receipt","description":"## Function Description\n* Registers a customer compensation (cash) request from the customer center into the refund information table.\n---\n## Detailed Description\n* Registers the requested customer compensation information into the refund information table.\n* Returns a refund number if the information is successfully registered in the table.\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":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RefundAcceptRegisterResponse"}}}},"900":{"description":"Business processing error details","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":"Order No."},"mbrNo":{"type":"string","description":"Member No."},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Login ID"},"rfdTypCd":{"type":"string","description":"Refund Type Code (OM023)"},"rfdPrgsStatCd":{"type":"string","description":"Refund Progress Status Code (OM024)"},"rfdBankCd":{"type":"string","description":"Refund Bank Code (OM026)"},"rfdActnNo":{"type":"string","description":"Refund Account No."},"rfdActnDepositorNm":{"type":"string","description":"Refund Account Holder"},"rfdCausCd":{"type":"string","description":"Refund Reason Code (OM025)"},"rfdActnCertiYn":{"type":"string","description":"Refund Account Verification Status"},"rfdAmt":{"type":"integer","description":"Refund Amount","format":"int64"},"rfdCmsnAmt":{"type":"integer","description":"Refund Fee Amount","format":"int64"},"acptmnId":{"type":"string","description":"Receiver ID"},"rfdSmsSndYn":{"type":"string","description":"Refund SMS Sent Status"}},"description":"Refund Registration 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"}}}}
```