> 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/back-office-api/payment-bo-api/undefined-3.md).
# 결제내역 조회
## 마일리지 결제 환불 요청
> \## 기능설명\
> \* 환불접수 상태의 마일리지 환불 건들을 환불하는 기능입니다.\
> \---\
> \## 상세설명\
> \* \[BO] 주문/결제 > 결제/모니터링 관리 > 마일리지 결제내역 조회 페이지에서 환불완료 버튼 클릭 시 호출됩니다.\
> \* 복합결제 환불 도중 오류가 발생하여, PG 결제는 환불이 되었으나 마일리지는 환불이 안된 경우 사용하는 기능입니다.\
> \* \*\*결제구분코드(OM012) : 환불(20), 결제수단코드(OM013) : 마일리지(32), 결제상태코드(OM014) : 환불접수(21)\*\* 가 필수 조건입니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 사이트 검색조건 및 결과컬럼 추가
```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":{"MileagePaymentRequest":{"type":"object","description":"마일리지 결제내역 조회 Request","properties":{"searchStartDt":{"type":"string","format":"date","description":"결제일자(시작)"},"searchEndDt":{"type":"string","format":"date","description":"결제일자(끝)"},"ordNo":{"type":"string","description":"주문번호"},"payGbCd":{"type":"string","description":"결제구분코드(OM012) 10:결제, 20:환불"},"payStatCd":{"type":"string","description":"결제상태코드(OM014) 11:결제대기, 12:결제완료, 13:결제취소, 21:환불접수, 22:환불완료, 23:환불접수취소"},"payStatCdList":{"type":"array","description":"결제상태코드(OM014) 11:결제대기, 12:결제완료, 13:결제취소, 21:환불접수, 22:환불완료, 23:환불접수취소","items":{"type":"string"}},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007) 10:전화상담(CC), 20:PC, 30:모바일웹, 40:안드로이드앱, 50:IOS앱"},"payNo":{"type":"string","description":"결제번호"},"uprPayNo":{"type":"string","description":"상위결제번호"},"ordDtlGbCd":{"type":"string","description":"주문상세구분코드(OM003) 10:주문일반, 11:주문취소, 20:반품일반, 21:반품취소, 30:교환주문, 31:교환취소, 40:교환반품"},"claimNo":{"type":"string","description":"클레임번호"},"rfdAmt":{"type":"number","description":"환불요청금액"},"payAmt":{"type":"number","description":"결제금액"},"mbrNo":{"type":"string","description":"회원번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013) 11:신용카드, 12:실시간계좌이체, 32:마일리지"},"dateSelect":{"type":"string","description":"기간유형"}}}}},"paths":{"/v1/payment/paymentDetailsMgmt/refundMileagePayment":{"post":{"tags":["결제내역 조회"],"summary":"마일리지 결제 환불 요청","description":" ## 기능설명\n * 환불접수 상태의 마일리지 환불 건들을 환불하는 기능입니다.\n ---\n ## 상세설명\n * [BO] 주문/결제 > 결제/모니터링 관리 > 마일리지 결제내역 조회 페이지에서 환불완료 버튼 클릭 시 호출됩니다.\n * 복합결제 환불 도중 오류가 발생하여, PG 결제는 환불이 되었으나 마일리지는 환불이 안된 경우 사용하는 기능입니다.\n * **결제구분코드(OM012) : 환불(20), 결제수단코드(OM013) : 마일리지(32), 결제상태코드(OM014) : 환불접수(21)** 가 필수 조건입니다.\n ---\n ## 수정번호\n * Release v2.00_240425: 사이트 검색조건 및 결과컬럼 추가\n","operationId":"refundMileagePayment","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MileagePaymentRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}}}}}}}
```
## 마일리지 결제내역 조회
> \## 기능설명\
> \* 마일리지로 결제한 내역들을 조회합니다.\
> \---\
> \## 상세설명\
> \* \[BO] 주문/결제 > 결제/모니터링 관리 > 마일리지 결제내역 조회 페이지에서 조회 버튼 클릭 시 호출됩니다.\
> \* \*\*결제일자(시작일자, 종료일자)\*\*는 필수 조회 조건입니다.\
> \* \*\*주문번호, 결제번호, 결제구분, 결제상태, 주문매체\*\*는 선택 조회 조건입니다.\
> \* 조회결과는 \*\*결제번호, 결제수단, 결제구분, 결제상태, 주문매체, 주문번호, 회원명, 결제/환불완료일시, 결제금액\*\* 입니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 사이트 검색조건 및 결과컬럼 추가\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경
```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":{"MileagePaymentRequest":{"type":"object","description":"마일리지 결제내역 조회 Request","properties":{"searchStartDt":{"type":"string","format":"date","description":"결제일자(시작)"},"searchEndDt":{"type":"string","format":"date","description":"결제일자(끝)"},"ordNo":{"type":"string","description":"주문번호"},"payGbCd":{"type":"string","description":"결제구분코드(OM012) 10:결제, 20:환불"},"payStatCd":{"type":"string","description":"결제상태코드(OM014) 11:결제대기, 12:결제완료, 13:결제취소, 21:환불접수, 22:환불완료, 23:환불접수취소"},"payStatCdList":{"type":"array","description":"결제상태코드(OM014) 11:결제대기, 12:결제완료, 13:결제취소, 21:환불접수, 22:환불완료, 23:환불접수취소","items":{"type":"string"}},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007) 10:전화상담(CC), 20:PC, 30:모바일웹, 40:안드로이드앱, 50:IOS앱"},"payNo":{"type":"string","description":"결제번호"},"uprPayNo":{"type":"string","description":"상위결제번호"},"ordDtlGbCd":{"type":"string","description":"주문상세구분코드(OM003) 10:주문일반, 11:주문취소, 20:반품일반, 21:반품취소, 30:교환주문, 31:교환취소, 40:교환반품"},"claimNo":{"type":"string","description":"클레임번호"},"rfdAmt":{"type":"number","description":"환불요청금액"},"payAmt":{"type":"number","description":"결제금액"},"mbrNo":{"type":"string","description":"회원번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013) 11:신용카드, 12:실시간계좌이체, 32:마일리지"},"dateSelect":{"type":"string","description":"기간유형"}}},"RealGridListResponseMileagePaymentResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MileagePaymentResponse"}}}},"MileagePaymentResponse":{"type":"object","description":"마일리지 결제내역 조회 Response","properties":{"payGbCd":{"type":"string","description":"결제구분코드(OM012)"},"payGbNm":{"type":"string","description":"결제구분코드명(OM012)"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayNm":{"type":"string","description":"결제수단코드명(OM013)"},"payStatCd":{"type":"string","description":"결제상태코드(OM014)"},"payStatNm":{"type":"string","description":"결제상태코드명(OM014)"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"ordMediaNm":{"type":"string","description":"주문매체코드명(OM007)"},"ordNo":{"type":"string","description":"주문번호"},"siteNm":{"type":"string","description":"사이트명"},"ordManNm":{"type":"string","description":"회원명"},"mbrNo":{"type":"string","description":"회원번호"},"payFnshDtm":{"type":"string","format":"date-time","description":"결제/환불완료일시"},"rfdPsbAmt":{"type":"integer","format":"int64","description":"환불가능금액"},"payAmt":{"type":"integer","format":"int64","description":"결제금액"},"rfdAmt":{"type":"integer","format":"int64","description":"환불요청금액"},"sctnCnclPsbYn":{"type":"string","description":"부분취소가능여부"},"payNo":{"type":"string","description":"결제번호"},"uprPayNo":{"type":"string","description":"상결제번호"},"ordDtlGbCd":{"type":"string","description":"주문상세구분코드(OM003)"},"claimNo":{"type":"string","description":"클레임번호"},"loginId":{"type":"string","description":"plateerId"}}}}},"paths":{"/v1/payment/paymentDetailsMgmt/getMileagePaymentList":{"get":{"tags":["결제내역 조회"],"summary":"마일리지 결제내역 조회","description":" ## 기능설명\n * 마일리지로 결제한 내역들을 조회합니다.\n ---\n ## 상세설명\n * [BO] 주문/결제 > 결제/모니터링 관리 > 마일리지 결제내역 조회 페이지에서 조회 버튼 클릭 시 호출됩니다.\n * **결제일자(시작일자, 종료일자)**는 필수 조회 조건입니다.\n * **주문번호, 결제번호, 결제구분, 결제상태, 주문매체**는 선택 조회 조건입니다.\n * 조회결과는 **결제번호, 결제수단, 결제구분, 결제상태, 주문매체, 주문번호, 회원명, 결제/환불완료일시, 결제금액** 입니다.\n ---\n ## 수정번호\n * Release v2.00_240425: 사이트 검색조건 및 결과컬럼 추가\n * Release v2.00_240530: 날짜조회 쿼리 변경\n","operationId":"getMileagePaymentList","parameters":[{"name":"mileagePaymentRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MileagePaymentRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMileagePaymentResponse"}}}}}}}}}
```
## 현금 결제내역 조회
> \## 기능 설명\
> \- 현금 결제내역을 조회하는 API 입니다.\
> \---\
> \## 상세 내용\
> \- 실시간계좌이체 결제내역과 총 카운트를 응답합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 사이트 검색조건 및 결과컬럼 추가\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경\
> \* Release v2.00\_240925: PG사 검색조건 추가
```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":{"CashPaymentRequest":{"type":"object","properties":{"searchStartDt":{"type":"string","format":"date","description":"조회시작일자(결제일자)"},"searchEndDt":{"type":"string","format":"date","description":"조회종료일자(결제일자)"},"ordNo":{"type":"string","description":"주문번호"},"pgCd":{"type":"string","description":"PG구분코드(OM030)"},"bankCd":{"type":"string","description":"은행코드(OM026)"},"payGbCd":{"type":"string","description":"결제구분코드(OM012) 10:결제,20:환불"},"payStatCd":{"type":"string","description":"결제상태코드(OM014) 11:결제대기,12:결제완료,13:결제취소,21:환불접수,22:환불완료,23:환불접수취소"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007) 20:PC,30:모바일웹,40:안드로이드앱,50:IOS앱"},"payWayCd":{"type":"string","description":"결제수단코드(OM013) 12:실시간계좌이체,13:가상계좌"},"dateSelect":{"type":"string","description":"기간유형"}}},"RealGridListResponseCashPaymentResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CashPaymentResponse"}}}},"CashPaymentResponse":{"type":"object","properties":{"payGbNm":{"type":"string","description":"결제구분코드명(OM012)"},"payWayNm":{"type":"string","description":"결제수단코드명(OM013)"},"payStatNm":{"type":"string","description":"결제상태코드명(OM014)"},"ordMediaNm":{"type":"string","description":"주문매체코드명(OM007)"},"ordNo":{"type":"string","description":"주문번호"},"siteNm":{"type":"string","description":"사이트명"},"ordManNm":{"type":"string","description":"주문자명"},"payFnshDtm":{"type":"string","format":"date-time","description":"결제/환불완료일시"},"payAmt":{"type":"integer","format":"int64","description":"결제금액"},"bankNm":{"type":"string","description":"은행명(OM026)"},"pgGbNm":{"type":"string","description":"PG사명(OM030)"},"payNo":{"type":"string","description":"결제번호"},"dptFcstDt":{"type":"string","description":"입금기한일자"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"plateerId"}}},"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":{"/v1/payment/paymentDetailsMgmt/getCashPaymentList":{"get":{"tags":["결제내역 조회"],"summary":"현금 결제내역 조회","description":"## 기능 설명\n- 현금 결제내역을 조회하는 API 입니다.\n---\n## 상세 내용\n- 실시간계좌이체 결제내역과 총 카운트를 응답합니다.\n---\n## 수정번호\n* Release v2.00_240425: 사이트 검색조건 및 결과컬럼 추가\n* Release v2.00_240530: 날짜조회 쿼리 변경\n* Release v2.00_240925: PG사 검색조건 추가\n","operationId":"getCashPaymentList","parameters":[{"name":"cashPaymentRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CashPaymentRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCashPaymentResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 신용카드 결제내역 조회
> \## 기능 설명\
> \- 신용카드 결제내역을 조회하는 API 입니다.\
> \---\
> \## 상세 설명\
> \- 신용카드 결제내역과 총 카운트를 응답합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 사이트 검색조건 및 결과컬럼 추가\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경
```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":{"CardPaymentRequest":{"type":"object","properties":{"searchStartDt":{"type":"string","format":"date","description":"조회시작일자(결제일자)"},"searchEndDt":{"type":"string","format":"date","description":"조회종료일자(결제일자)"},"ordNo":{"type":"string","description":"주문번호"},"aprvNo":{"type":"string","description":"승인번호"},"payGbCd":{"type":"string","description":"결제구분코드(OM012) 10:결제,20:환불"},"payStatCd":{"type":"string","description":"결제상태코드(OM014) 11:결제대기,12:결제완료,13:결제취소,21:환불접수,22:환불완료,23:환불접수취소"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007) 20:PC,30:모바일웹,40:안드로이드앱,50:IOS앱"},"payWayCd":{"type":"string","description":"결제수단코드(OM013) 11:신용카드, 12:실시간계좌이체, 32:마일리지"},"dateSelect":{"type":"string","description":"기간유형"}}},"RealGridListResponseCardPaymentResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/CardPaymentResponse"}}}},"CardPaymentResponse":{"type":"object","properties":{"payGbNm":{"type":"string","description":"결제구분코드명(OM012)"},"payWayNm":{"type":"string","description":"결제수단코드명(OM013)"},"payStatNm":{"type":"string","description":"결제상태코드명(OM014)"},"ordMediaNm":{"type":"string","description":"주문매체명(OM007)"},"ordNo":{"type":"string","description":"주문번호"},"siteNm":{"type":"string","description":"사이트명"},"ordManNm":{"type":"string","description":"주문자명"},"payFnshDtm":{"type":"string","format":"date-time","description":"결제/환불완료일시"},"payAmt":{"type":"integer","format":"int64","description":"결제금액"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrNm":{"type":"string","description":"매입사코드명(OM028)"},"divMonCnt":{"type":"integer","format":"int32","description":"할부개월수"},"aprvNo":{"type":"string","description":"승인번호"},"aprvDtm":{"type":"string","format":"date","description":"승인일시"},"pgGbNm":{"type":"string","description":"PG사명"},"payNo":{"type":"string","description":"결제번호"},"loginId":{"type":"string","description":"plateerId"},"mbrNo":{"type":"string","description":"회원번호"}}},"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":{"/v1/payment/paymentDetailsMgmt/getCardPaymentList":{"get":{"tags":["결제내역 조회"],"summary":"신용카드 결제내역 조회","description":"## 기능 설명\n- 신용카드 결제내역을 조회하는 API 입니다.\n---\n## 상세 설명\n- 신용카드 결제내역과 총 카운트를 응답합니다.\n---\n## 수정번호\n* Release v2.00_240425: 사이트 검색조건 및 결과컬럼 추가\n* Release v2.00_240530: 날짜조회 쿼리 변경\n","operationId":"getCardPaymentList","parameters":[{"name":"cardPaymentRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/CardPaymentRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseCardPaymentResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
---
# 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/back-office-api/payment-bo-api/undefined-3.md?ask=&goal=
```
`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.