> 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/back-office-api-reference/payment-bo-api/refund-management.md). # Refund Management ## Update Refund Processing Result > \## Function Description\ > \- API that updates the refund processing result.\ > \---\ > \## Detailed Description\ > \- Processes the requested refund number list as refund request cancellation.\ > \- Only refunds in a status eligible for request cancellation are cancelled.
```json {"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RefundProcRsltUpdateRequest":{"type":"object","properties":{"dataList":{"type":"array","description":"Refund Processing Result List","items":{"$ref":"#/components/schemas/RefundProcRslt"},"minItems":1}},"required":["dataList"]},"RefundProcRslt":{"type":"object","properties":{"rfdNo":{"type":"string","description":"Refund No.","minLength":1},"rfdProcRsltCd":{"type":"string","description":"Refund Processing Result Code (OM049) 10: Unprocessed, 20: Success, 30: Failure","minLength":1}},"required":["rfdNo","rfdProcRsltCd"]},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/payment/refundMgmt/saveRefundProcRslt":{"post":{"tags":["Refund Management"],"summary":"Update Refund Processing Result","description":"## Function Description\n- API that updates the refund processing result.\n---\n## Detailed Description\n- Processes the requested refund number list as refund request cancellation.\n- Only refunds in a status eligible for request cancellation are cancelled.\n","operationId":"saveRefundProcRslt","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundProcRsltUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}} ``` ## Complete Original Payment Refund > \## Function Description\ > \* Completes 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\*\*\ > \* Processing is possible when 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 the API is called to verify whether the completion processing is possible.\ > \* The order history status code (OM005) value in the order detail table is changed to Return Completed (37) (including free gifts), and the order completion date/time (ordFnshDtm) is updated.
```json {"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RefundBundleApproMgmtCUDSaveRequest":{"type":"object","description":"Original Order Refund Completion Processing Request DTO","properties":{"claimBusinessType":{"type":"string","description":"Claim Business Type","enum":["ORDER_CANCEL","RETURN_ACCEPT","RETURN_WITHDRAWAL","EXCHANGE_ACCEPT","EXCHANGE_WITHDRAWAL","RETURN_COMPLETE","RETURN_REJECT","RETURN_TRANSFORM"]},"ordNo":{"type":"string","description":"Order No."},"ordMediaCd":{"type":"string","description":"Order Channel Code"},"systemType":{"type":"string","description":"System Type","enum":["FO","BO"]},"claimNo":{"type":"string","description":"Claim No."}},"required":["claimBusinessType","ordMediaCd","ordNo","systemType"]},"ResponseListRefundBundleApproMgmtCUDResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/RefundBundleApproMgmtCUDResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RefundBundleApproMgmtCUDResponse":{"type":"object","description":"Original Order Refund Completion Processing Response DTO","properties":{"claimNo":{"type":"string","description":"Claim No."},"resultCode":{"type":"string","description":"Result Code"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/payment/refundMgmt/saveRefundBundleApproMgmtList":{"post":{"tags":["Refund Management"],"summary":"Complete Original Payment Refund","description":"## Function Description\n* Completes 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 * Processing is possible when 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 the API is called to verify whether the completion processing is possible.\n * The order history status code (OM005) value in the order detail table is changed to Return Completed (37) (including free gifts), and the order completion date/time (ordFnshDtm) is updated.\n","operationId":"saveRefundBundleApproMgmtList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RefundBundleApproMgmtCUDSaveRequest"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListRefundBundleApproMgmtCUDResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}} ``` ## Update Manual Refund Processing Excel Upload > \## Function Description\ > \- Updates the refund status via the manual refund processing Excel file.\ > \---\ > \## Detailed Description\ > \- The update fails if the account information does not match.
```json {"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RefundExcelUploadRequest":{"type":"object","properties":{"excelDataList":{"type":"array","items":{"$ref":"#/components/schemas/RefundExcelRow"}}}},"RefundExcelRow":{"type":"object","properties":{"rfdNo":{"type":"string","description":"Refund No."},"ordNo":{"type":"string","description":"Order No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"rfdTypNm":{"type":"string","description":"Refund Type (OM023) Order Refund, Compensation Refund"},"rfdPrgsStatNm":{"type":"string","description":"Refund Progress Status (OM024). Refund Requested, Refund Completed, Refund Request Cancelled"},"rfdBankNm":{"type":"string","description":"Refund Bank (OM026)"},"rfdActnNo":{"type":"string","description":"Refund Account No."},"rfdActnDepositorNm":{"type":"string","description":"Refund Account Holder Name"},"rfdCausNm":{"type":"string","description":"Refund Reason (OM025). Order Cancellation, Exchange, Return, Compensation Refund, Other"},"rfdAmt":{"type":"number","description":"Refund Amount"},"acptmnId":{"type":"string","description":"Receiver ID"},"acptmnNm":{"type":"string","description":"Receiver Name"},"accpDtm":{"type":"string","description":"Receipt Date/Time"},"rfdProcRsltNm":{"type":"string","description":"Refund Processing Result (OM049). Unprocessed, Success, Failure"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/payment/refundMgmt/refundExcelUpload":{"post":{"tags":["Refund Management"],"summary":"Update Manual Refund Processing Excel Upload","description":"## Function Description\n- Updates the refund status via the manual refund processing Excel file.\n---\n## Detailed Description\n- The update fails if the account information does not match.\n","operationId":"refundExcelUpload","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundExcelUploadRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}} ``` ## Cancel Refund Request > \## Function Description\ > \- API that processes the request cancellation of a manual refund record.\ > \---\ > \## Detailed Description\ > \- Processes the requested refund number list as refund request cancellation.\ > \- Only refunds in a status eligible for request cancellation are cancelled.
```json {"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RefundAcceptCancelRequest":{"type":"object","properties":{"rfdNoList":{"type":"array","description":"Refund No. List","items":{"type":"string","minLength":1},"minItems":1}},"required":["rfdNoList"]},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/payment/refundMgmt/cancelRefundAccept":{"post":{"tags":["Refund Management"],"summary":"Cancel Refund Request","description":"## Function Description\n- API that processes the request cancellation of a manual refund record.\n---\n## Detailed Description\n- Processes the requested refund number list as refund request cancellation.\n- Only refunds in a status eligible for request cancellation are cancelled.\n","operationId":"cancelRefundAccept","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundAcceptCancelRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}} ``` ## Check Permission for Manual Refund Processing Excel Download > \## Function Description\ > \- API that checks whether the user has permission to download the manual refund processing Excel file.\ > \---\ > \## Detailed Description\ > \- Checks whether the user has permission to download the requested refund processing Excel file.\ > \- Permission to view ID, name, and account number is required to download the Excel file.
```json {"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/payment/refundMgmt/hasRefundExcelDownloadPermission":{"get":{"tags":["Refund Management"],"summary":"Check Permission for Manual Refund Processing Excel Download","description":"## Function Description\n- API that checks whether the user has permission to download the manual refund processing Excel file.\n---\n## Detailed Description\n- Checks whether the user has permission to download the requested refund processing Excel file.\n- Permission to view ID, name, and account number is required to download the Excel file.\n","operationId":"hasRefundExcelDownloadPermission","responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"boolean"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}} ``` ## Search Manual Refund History > \## Function Description\ > \- API that retrieves the manual refund history.\ > \---\ > \## Detailed Description\ > \- If the from value is "ACCEPT", completed refunds are excluded from the search.\ > \- If the from value is "COMPLETE", cancelled refunds are excluded from the search.
```json {"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RefundMgmtRequest":{"type":"object","properties":{"from":{"type":"string","description":"Request Screen. Accepted: ACCEPT, Completed: COMPLETE","enum":["ACCEPT","COMPLETE"],"minLength":1},"rfdDtmOption":{"type":"string","description":"Refund Period Condition Value. Accepted Date/Time: ACCEPT, Completed Date/Time: COMPLETE","enum":["ACCEPT","COMPLETE"],"minLength":1},"startDtm":{"type":"string","format":"date","description":"Search Start Date"},"endDtm":{"type":"string","format":"date","description":"Search End Date"},"condKdOption":{"type":"string","description":"Search Condition. Order No.: ordAmt, Refund Request Amount: refundAmount)","enum":["ordNo","refundAmount"]},"condKdVl":{"type":"string","description":"Search Condition Value"},"rfdCausCd":{"type":"string","description":"Refund Reason Code (OM025) 10: Order Cancellation, 11: Exchange, 12: Return, 31: Compensation Refund, 99: Other"},"rfdPrgsStatCd":{"type":"string","description":"Refund Progress Status Code (OM024) 10: Refund Requested, 30: Refund Completed, 99: Refund Request Cancelled"},"mbrNo":{"type":"string","description":"Member No."},"rfdProcRsltCd":{"type":"string","description":"Refund Status Code (OM049) 10: Unprocessed, 20: Success, 30: Failure"},"ordNo":{"type":"string","description":"Order No."},"dateSelect":{"type":"string","description":"Search Period Full Type Value"}},"required":["endDtm","from","rfdDtmOption","startDtm"]},"RealGridListResponseRefundMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/RefundMgmtResponse"}}}},"RefundMgmtResponse":{"type":"object","properties":{"accpDtm":{"type":"string","format":"date-time","description":"Search Start Date"},"fnshDtm":{"type":"string","format":"date-time","description":"Search End Date"},"rfdPrgsStatCd":{"type":"string","description":"Refund Progress Status Code (OM024)"},"rfdPrgsStatCdNm":{"type":"string","description":"Refund Progress Status Code Name (OM024)"},"ordNo":{"type":"string","description":"Order No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Login ID"},"mbrNm":{"type":"string","description":"Member Name"},"rfdBankCd":{"type":"string","description":"Bank Code (OM026)"},"rfdBankCdNm":{"type":"string","description":"Bank Code Name (OM026)"},"rfdActnNo":{"type":"string","description":"Refund Account No."},"rfdActnDepositorNm":{"type":"string","description":"Account Holder"},"rfdAmt":{"type":"number","description":"Refund Amount"},"rfdCausCd":{"type":"string","description":"Refund Reason Code (OM025)"},"rfdCausCdNm":{"type":"string","description":"Refund Reason Code Name (OM025)"},"fnshmnId":{"type":"string","description":"Completer ID"},"fnshmnNm":{"type":"string","description":"Completer Name"},"acptmnId":{"type":"string","description":"Receiver ID"},"acptmnNm":{"type":"string","description":"Receiver Name"},"rfdProcRsltCd":{"type":"string","description":"Refund Processing Result Code (OM049)"},"rfdProcRsltCdNm":{"type":"string","description":"Refund Processing Result Code Name (OM049)"},"rfdNo":{"type":"string","description":"Refund No."},"originRfdProcRsltCd":{"type":"string","description":"Refund Processing Result Code for Grid Selectbox Control"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/payment/refundMgmt/getRefundMgmtList":{"get":{"tags":["Refund Management"],"summary":"Search Manual Refund History","description":"## Function Description\n- API that retrieves the manual refund history.\n---\n## Detailed Description\n- If the from value is \"ACCEPT\", completed refunds are excluded from the search.\n- If the from value is \"COMPLETE\", cancelled refunds are excluded from the search.\n","operationId":"getRefundAcceptMgmtList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RefundMgmtRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseRefundMgmtResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}} ``` ## Download Manual Refund Processing Excel > \## Function Description\ > \- API that downloads the Excel file of manual refund processing targets.\ > \---\ > \## Detailed Description\ > \- Downloads, as an Excel file, the list of refunds eligible for refund completion processing.
```json {"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"IndInfoLogCommonEntity":{"type":"object","properties":{"qryGbCd":{"type":"string","description":"Personal Information Access Type Code (UR014) 10: View, 20: Excel Download, 30: Modify"},"indInfoQryCaus":{"type":"string","description":"Access Reason Content"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","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"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/payment/refundMgmt/getRefundExcelData":{"get":{"tags":["Refund Management"],"summary":"Download Manual Refund Processing Excel","description":"## Function Description\n- API that downloads the Excel file of manual refund processing targets.\n---\n## Detailed Description\n- Downloads, as an Excel file, the list of refunds eligible for refund completion processing.\n","operationId":"getRefundExcelData","parameters":[{"name":"indiInfoLog","in":"query","required":true,"schema":{"$ref":"#/components/schemas/IndInfoLogCommonEntity"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}} ``` ## Search Original Order Refund Completion Processing Targets > \## Function Description\ > \* Retrieves the list of original order refund completion processing targets in BO.\ > \---\ > \## Detailed Description\ > \* The order return amount is 0 won or more \*\*((Order Quantity – Cancel Quantity – Return Quantity) \* Quantity > 0)\*\*\ > \* \*\*Order History Type (OM003)\*\* value is \*\*Return (20)\*\*\ > \* \*\*Order History Status Code (OM005)\*\* value is \*\*Collection Completed (36)\*\*, \*\*Return Completed (37)\*\*\ > \* In addition to the above (basic) conditions, additional search conditions are applied as specified. (You can select \*\*Order Progress Status (OM005)\*\* as \*\*Collection Completed (36)\*\* or \*\*Return Completed (37)\*\* in the search conditions.)\ > \---\ > \## Revision History\ > \* Release v2.00\_240613: Improved period search condition
```json {"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RefundBundleApproMgmtRequest":{"type":"object","description":"Search Original Order Refund Completion Processing Targets Request DTO","properties":{"entrNo":{"type":"string","description":"Vendor No."},"ordNo":{"type":"string","description":"Order No."},"comboRfndDtm":{"type":"string","description":"Return Registration Date/Refund Processing Completion Date","minLength":1},"startDate":{"type":"string","format":"date","description":"Period (Start)"},"endDate":{"type":"string","format":"date","description":"Period (End)"},"ordManInfoGb":{"type":"string","description":"(Orderer Info) Name/Mobile Phone"},"ordManInfo":{"type":"string","description":"(Orderer Info) Name/Mobile Phone Search Content"},"ordStatCd":{"type":"string","description":"Order Progress Status (OM005)"},"mbrId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"pgApprRslt":{"type":"string","description":"PG Approval Result"},"dateSelect":{"type":"string","description":"Period Type"}},"required":["comboRfndDtm","endDate","startDate"]},"RealGridListResponseRefundBundleApproMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/RefundBundleApproMgmtResponse"}}}},"RefundBundleApproMgmtResponse":{"type":"object","description":"Search Original Order Refund Completion Processing Targets Response DTO","properties":{"ordNo":{"type":"string","description":"Order No."},"loginId":{"type":"string","description":"Login ID"},"ordManNm":{"type":"string","description":"Orderer Name"},"cellNo":{"type":"string","description":"Mobile Phone No."},"ordMediaCd":{"type":"string","description":"Order Channel Code (OM007)"},"returnAccpDtm":{"type":"string","format":"date-time","description":"Return Reception Date/Time"},"claimNo":{"type":"string","description":"Claim No."},"ordPrc":{"type":"number","description":"Order Amount"},"ordDtlStatCd":{"type":"string","description":"Order Detail Status Code (OM005)"},"ordDtlStatCdNm":{"type":"string","description":"Order Detail Status Code Name"},"pgAprvCd":{"type":"string","description":"PG Approval Result"},"pgAprvCdNm":{"type":"string","description":"PG Approval Result Name"},"rfdFnshDtm":{"type":"string","format":"date-time","description":"Refund Completion Date/Time"},"rfdPayStatCd":{"type":"string","description":"Refund Payment Status Code (OM014)"},"rfdPayStatCdNm":{"type":"string","description":"Refund Payment Status Code Name"},"pgGbCd":{"type":"string","description":"PG Classification Code (OM030)"},"pgGbCdNm":{"type":"string","description":"PG Type Code Name"},"payWayCd":{"type":"string","description":"Payment Method Code (OM013)"},"payWayCdNm":{"type":"string","description":"Payment Method Code Name"},"cancelAmt":{"type":"number","description":"Cancellation Amount"},"mainCancelAmt":{"type":"number","description":"Primary Payment Cancellation Amount"},"milgCancelAmt":{"type":"number","description":"Mileage Cancellation Amount"},"rfdAmt":{"type":"number","description":"Refund Amount"},"errorConts":{"type":"string","description":"Refund Error Details"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"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"}}}}},"paths":{"/v2/payment/refundMgmt/getRefundBundleApproMgmtList":{"get":{"tags":["Refund Management"],"summary":"Search Original Order Refund Completion Processing Targets","description":" ## Function Description\n * Retrieves the list of original order refund completion processing targets in BO.\n ---\n ## Detailed Description\n * The order return amount is 0 won or more **((Order Quantity – Cancel Quantity – Return Quantity) * Quantity > 0)**\n * **Order History Type (OM003)** value is **Return (20)**\n * **Order History Status Code (OM005)** value is **Collection Completed (36)**, **Return Completed (37)**\n * In addition to the above (basic) conditions, additional search conditions are applied as specified. (You can select **Order Progress Status (OM005)** as **Collection Completed (36)** or **Return Completed (37)** in the search conditions.)\n ---\n## Revision History\n* Release v2.00_240613: Improved period search condition\n","operationId":"getRefundBundleApproMgmtList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/RefundBundleApproMgmtRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseRefundBundleApproMgmtResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}} ```