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