# 결제정보
## 마일리지 환불 처리
> \## 기능 설명\
> \* \[BO전용] 환불접수 상태 마일리지 결제 취소 건들을 환불완료 처리합니다.\
> \---\
> \## 상세 설명\
> \* 마일리지 환불 도중 에러가 발생하여 환불이 안된 결제건들을 재환불 요청하는 기능입니다.\
> \* 결제기본테이블에 환불데이터들 중, 환불접수 상태인 건들이 대상입니다.\
> \* \*\*주문번호, 주문매체코드, 결제번호, 상위결제번호, 클레임번호, 환불요청금액, 결제금액, 회원번호, 결제수단코드\*\*는 필수 요청 조건입니다.\
> \* 정상적으로 환불이 되면, 환불접수 상태가 환불완료 상태로 변경됩니다.
```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/refundMileagePayment":{"post":{"tags":["결제정보"],"summary":"마일리지 환불 처리","description":"## 기능 설명\n* [BO전용] 환불접수 상태 마일리지 결제 취소 건들을 환불완료 처리합니다.\n---\n## 상세 설명\n* 마일리지 환불 도중 에러가 발생하여 환불이 안된 결제건들을 재환불 요청하는 기능입니다.\n* 결제기본테이블에 환불데이터들 중, 환불접수 상태인 건들이 대상입니다.\n* **주문번호, 주문매체코드, 결제번호, 상위결제번호, 클레임번호, 환불요청금액, 결제금액, 회원번호, 결제수단코드**는 필수 요청 조건입니다.\n* 정상적으로 환불이 되면, 환불접수 상태가 환불완료 상태로 변경됩니다.\n","operationId":"refundMileagePayment","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MileagePaymentRequest"}}}},"required":true},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"MileagePaymentRequest":{"type":"object","properties":{"searchStartDt":{"type":"string","description":"결제일자(시작)","format":"date"},"searchEndDt":{"type":"string","description":"결제일자(끝)","format":"date"},"ordNo":{"type":"string","description":"주문번호"},"payGbCd":{"type":"string","description":"OM012(결제구분코드)\n 10: 결제\n,20: 환불\n","enum":["PAYMENT","REFUND"]},"payStatCd":{"type":"string","description":"OM014(결제상태코드)\n 11: 결제대기\n,12: 결제완료\n,13: 결제취소\n,21: 환불접수\n,22: 환불완료\n,23: 환불접수취소\n","enum":["PAY_WAIT","PAY_COMPLETE","PAY_CANCEL","REFUND_REQUEST","REFUND_COMPLETE","REFUND_REQUEST_CANCEL"]},"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"]},"payNo":{"type":"string","description":"결제번호"},"uprPayNo":{"type":"string","description":"상위결제번호"},"ordDtlGbCd":{"type":"string","description":"OM003(주문내역구분코드)\n 10: 주문일반\n , 11: 주문취소\n , 20: 반품일반\n , 21: 반품취소\n , 30: 교환주문\n , 31: 교환취소\n , 40: 교환반품\n","enum":["ORDER_GENERAL","ORDER_CANCEL","RETURN_GENERAL","RETURN_WITHDRAWAL","EXCHANGE_ORDER","EXCHANGE_WITHDRAWAL","EXCHANGE_RETURN"]},"claimNo":{"type":"string","description":"클레임번호"},"rfdAmt":{"type":"integer","description":"환불요청금액","format":"int64"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"mbrNo":{"type":"string","description":"회원번호"},"payWayCd":{"type":"string","description":"OM013(결제수단코드)\n 11: 신용카드\n,12: 실시간계좌이체\n,13: 가상계좌(무통장입금)\n,14: 네이버페이\n,15: 카카오페이\n,16: 페이코\n,17: 삼성페이\n,18: 애플페이\n,19: LPAY\n,20: 토스페이\n,21: SSG페이\n,32: 마일리지\n","enum":["CREDIT_CARD","REAL_TIME_ACCOUNT_TRANSFER","VBANK","NAVER_PAY","KAKAO_PAY","PAYCO","SAMSUNG_PAY","APPLE_PAY","L_PAY","TOSS_PAY","SSG_PAY","MILEAGE"]}},"description":"마일리지 환불 DTO"}}}}
```
## 가맹점 정보 조회
> \## 기능 설명\
> \* PG 결제를 위해 가맹점 정보를 조회합니다.\
> \---\
> \## 상세 설명\
> \* PG 구분코드(OM030), 시스템구분코드(OM051), 가맹점기타구분코드(OM052)는 필수 파라미터입니다.\
> \* BO admin > 결제관리 > 결제수단관리 > 가맹점관리에 등록된 가맹점을 조회합니다.\
> \* 조회 내역이 없을 경우 PG결제가 불가능합니다.\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 가맹점 정보 조회 사이트 검색조건 추가
```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/pgMerchant":{"post":{"tags":["결제정보"],"summary":"가맹점 정보 조회","description":"## 기능 설명\n* PG 결제를 위해 가맹점 정보를 조회합니다.\n---\n## 상세 설명\n* PG 구분코드(OM030), 시스템구분코드(OM051), 가맹점기타구분코드(OM052)는 필수 파라미터입니다.\n* BO admin > 결제관리 > 결제수단관리 > 가맹점관리에 등록된 가맹점을 조회합니다.\n* 조회 내역이 없을 경우 PG결제가 불가능합니다.\n---\n## 수정번호\n* Release v2.00_240425: 가맹점 정보 조회 사이트 검색조건 추가\n","operationId":"getPgMerchant","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMerchantRequest"}}},"required":true},"responses":{"200":{"description":"가맹점 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaymentMerchantResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PaymentMerchantRequest":{"required":["mersEtcGbCd","pgGbCd","sysGbCd"],"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"pgGbCd":{"type":"string","description":"OM030(PG구분코드)\n 10: 이니시스(INICIS)\n,20: 토스(TOSS)\n","enum":["INICIS","TOSS"]},"sysGbCd":{"type":"string","description":"시스템구분코드(OM051)"},"mersEtcGbCd":{"type":"string","description":"가맹점기타구분코드(OM052)"}},"description":"가맹점 정보 조회 DTO"},"PaymentMerchantResponse":{"type":"object","properties":{"mersNo":{"type":"string","description":"가맹점번호"},"termlId":{"type":"string","description":"터미널ID"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"mersEtcGbCd":{"type":"string","description":"가맹점기타구분코드(OM052)"},"pointUseYn":{"type":"string","description":"포인트사용여부"},"nintUseYn":{"type":"string","description":"무이자사용여부"},"useYn":{"type":"string","description":"사용여부"},"sysGbCd":{"type":"string","description":"시스템구분코드(OM051)"}},"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"}}}}
```
## 토스 빌링키 발급 요청 파라미터 생성
> \## 기능설명\
> \* 빌키발급요청할 때 필요한 파라미터를 생성하는 API입니다.\
> \---\
> \## 상세설명\
> \* timestamp, hashdata를 생성합니다.
```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/getTossAuthProperties":{"post":{"tags":["결제정보"],"summary":"토스 빌링키 발급 요청 파라미터 생성","description":"## 기능설명\n* 빌키발급요청할 때 필요한 파라미터를 생성하는 API입니다.\n---\n## 상세설명\n* timestamp, hashdata를 생성합니다.\n","operationId":"getTossAuthProperties","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TossAuthRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TossAuthResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"TossAuthRequest":{"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"termlId":{"type":"string","description":"터미널ID"}},"description":"토스 빌링키 발급 요청 Parameter 생성용 DTO"},"TossAuthResponse":{"type":"object","properties":{"timestamp":{"type":"string","description":"타임스템프 [TimeInMillis(Long형)]"},"hashData":{"type":"string","description":"SHA256 Hash값(대상: mid, orderid, timestamp)"}},"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"}}}}
```
## PG 정보 조회
> \## 기능설명\
> \* 결제수단 코드를 이용하여 PG 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 결제수단 코드에 맞는 현재 결제수단 연결여부가 Y 이고, 사용여부가 Y 인 PG 정보를 조회합니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240627: 사이트 조건 추가하여 사이트, 결제수단 코드에 맞는 결제수단 조회
```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/getPgInfo":{"post":{"tags":["결제정보"],"summary":"PG 정보 조회","description":"## 기능설명\n* 결제수단 코드를 이용하여 PG 정보를 조회합니다.\n---\n## 상세설명\n* 결제수단 코드에 맞는 현재 결제수단 연결여부가 Y 이고, 사용여부가 Y 인 PG 정보를 조회합니다.\n---\n## 수정 번호\n* Release v2.00_240627: 사이트 조건 추가하여 사이트, 결제수단 코드에 맞는 결제수단 조회\n","operationId":"getPgInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PgInfoResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PgInfoResponse":{"type":"object","properties":{"pgGbCd":{"type":"string"},"payWayCd":{"type":"string"},"payWayCdNm":{"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"}}}}
```
## 사이트 별 사용 중인 PG 구분코드 조회
> \## 기능설명\
> \* 사이트 별로 사용 중인 PG 사의 구분코드를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 사이트 번호, 시스템 구분, 가맹점 기타구분 코드로 사용여부 'Y'인 PG 구분코드를 조회합니다.
```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/getPgGbCdBySiteNo":{"post":{"tags":["결제정보"],"summary":"사이트 별 사용 중인 PG 구분코드 조회","description":"## 기능설명\n* 사이트 별로 사용 중인 PG 사의 구분코드를 조회하는 API입니다.\n---\n## 상세설명\n* 사이트 번호, 시스템 구분, 가맹점 기타구분 코드로 사용여부 'Y'인 PG 구분코드를 조회합니다.\n","operationId":"getPgGbCdBySiteNo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMerchantRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PaymentMerchantRequest":{"required":["mersEtcGbCd","pgGbCd","sysGbCd"],"type":"object","properties":{"siteNo":{"type":"string","description":"사이트번호"},"pgGbCd":{"type":"string","description":"OM030(PG구분코드)\n 10: 이니시스(INICIS)\n,20: 토스(TOSS)\n","enum":["INICIS","TOSS"]},"sysGbCd":{"type":"string","description":"시스템구분코드(OM051)"},"mersEtcGbCd":{"type":"string","description":"가맹점기타구분코드(OM052)"}},"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"}}}}
```
## 결제수단 연결여부 조회
> \## 기능설명\
> \* 결제수단 연결여부를 조회하는 API 입니다.\
> \---\
> \## 상세설명\
> \* 주문/결제 > 결제수단 관리 > 결제수단 관리에서 선택한 PG사에 등록된 결제수단의 연결여부를 조회합니다.
```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/getPayWayLinkYn":{"post":{"tags":["결제정보"],"summary":"결제수단 연결여부 조회","description":"## 기능설명\n* 결제수단 연결여부를 조회하는 API 입니다.\n---\n## 상세설명\n* 주문/결제 > 결제수단 관리 > 결제수단 관리에서 선택한 PG사에 등록된 결제수단의 연결여부를 조회합니다.\n","operationId":"getPayWayLinkYn","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentMethodRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaymentMethodResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PaymentMethodRequest":{"type":"object","properties":{"payWayCd":{"type":"string","description":"OM013(결제수단코드)\n 11: 신용카드\n,12: 실시간계좌이체\n,13: 가상계좌(무통장입금)\n,14: 네이버페이\n,15: 카카오페이\n,16: 페이코\n,17: 삼성페이\n,18: 애플페이\n,19: LPAY\n,20: 토스페이\n,21: SSG페이\n,32: 마일리지\n","enum":["CREDIT_CARD","REAL_TIME_ACCOUNT_TRANSFER","VBANK","NAVER_PAY","KAKAO_PAY","PAYCO","SAMSUNG_PAY","APPLE_PAY","L_PAY","TOSS_PAY","SSG_PAY","MILEAGE"]},"pgGbCd":{"type":"string","description":"OM030(PG구분코드)\n 10: 이니시스(INICIS)\n,20: 토스(TOSS)\n","enum":["INICIS","TOSS"]}},"description":"결제수단 연결여부 조회 DTO"},"PaymentMethodResponse":{"type":"object","properties":{"payWayCd":{"type":"string","description":"OM013(결제수단코드)\n 11: 신용카드\n,12: 실시간계좌이체\n,13: 가상계좌(무통장입금)\n,14: 네이버페이\n,15: 카카오페이\n,16: 페이코\n,17: 삼성페이\n,18: 애플페이\n,19: LPAY\n,20: 토스페이\n,21: SSG페이\n,32: 마일리지\n","enum":["CREDIT_CARD","REAL_TIME_ACCOUNT_TRANSFER","VBANK","NAVER_PAY","KAKAO_PAY","PAYCO","SAMSUNG_PAY","APPLE_PAY","L_PAY","TOSS_PAY","SSG_PAY","MILEAGE"]},"payWayNm":{"type":"string","description":"결제수단명"},"pgGbCd":{"type":"string","description":"OM030(PG구분코드)\n 10: 이니시스(INICIS)\n,20: 토스(TOSS)\n","enum":["INICIS","TOSS"]},"linkYn":{"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"}}}}
```
## 결제 배분
> \## 기능 설명\
> \* 결제 배분 정보를 생성합니다.\
> \---\
> \## 상세 설명\
> \* 총 결제금액 기준으로 결제 배분 정보를 생성합니다.\
> \* 결제 배분 포인트는 10원 단위입니다.
```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/getPayDivInfo":{"post":{"tags":["결제정보"],"summary":"결제 배분","description":" ## 기능 설명\n * 결제 배분 정보를 생성합니다.\n ---\n ## 상세 설명\n * 총 결제금액 기준으로 결제 배분 정보를 생성합니다.\n * 결제 배분 포인트는 10원 단위입니다.\n","operationId":"getPayDivInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentDivRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OpOrdPayDivInfo"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"PaymentDivRequest":{"type":"object","properties":{"adminOrdAmtProcTypCd":{"type":"string"},"totalAmt":{"type":"integer","format":"int64"},"crdtCardAmt":{"type":"integer","format":"int64"},"milgAmt":{"type":"integer","format":"int64"},"rltmActnTrsfAmt":{"type":"integer","format":"int64"},"virActnTrsfAmt":{"type":"integer","format":"int64"},"opOrdAdtnCostList":{"type":"array","items":{"$ref":"#/components/schemas/OpOrdAdtnCost"}},"opOrdPayDivInfoList":{"type":"array","items":{"$ref":"#/components/schemas/OpOrdPayDivInfo"}},"addPay":{"type":"boolean"}}},"OpOrdAdtnCost":{"type":"object","properties":{"ordAdtnSn":{"type":"string","description":"주문부가비용순번"},"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"deliNo":{"type":"string","description":"배송번호"},"uprOrdAdtnSn":{"type":"string","description":"상위부가비용순번"},"entrNo":{"type":"string","description":"협력사번호"},"adtnOcurGbCd":{"type":"string","description":"OM017(부가비용발생구분코드)\n 10: 발생\n , 20: 취소\n","enum":["OCCURRNECE","CANCEL"]},"ordCostGbCd":{"type":"string","description":"OM043(주문비용구분코드)\n 10: 배송비\n , 20: 회수반품비\n , 30: 교환배송비\n , 40: 추가배송비\n","enum":["DELIVERY_FEE","RETURN_FEE","EXCHANGE_FEE","EXTRA_FEE"]},"stdAdtnAmt":{"type":"integer","description":"기준부가비용금액","format":"int64"},"aplyAdtnAmt":{"type":"integer","description":"적용부가비용금액","format":"int64"},"cnclAdtnAmt":{"type":"integer","description":"취소부가비용금액","format":"int64"},"fvrAdtnAmt":{"type":"integer","description":"혜택부가비용금액","format":"int64"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlexTypCd":{"type":"string","description":"배송비유형코드","enum":["FREE","CHARGED","CONDITIONAL_FREE"]},"dlexCnclCausCd":{"type":"string","description":"OM022(배송비취소사유코드)\n 10: N/A\n , 20: 무료배송권\n , 30: 고객클레임\n , 40: 당사귀책사유\n","enum":["NOT_APPLICABLE","FREE_DELIVERY_COUPON","CUSTOMER_CLAIM","COMPANY_FALUT"]},"dlexAmt":{"type":"integer","description":"배송비금액","format":"int64"},"adtnBassNo":{"type":"string","description":"부가비용근거번호"},"adtnDtlBassNo":{"type":"string","description":"부가비용상세근거번호"},"fvrPolcTypCd":{"type":"string","description":"OM020(혜택정책유형코드)\n 00: 사용안함\n , 11: 정액할인\n , 12: 정률할인\n , 21: 정액적립\n , 22: 정률적립\n","enum":["NOT_AVAILABLE","DISCOUNT_PRICE","DISCOUNT_RATE","ACCUMULATE_PRICE","ACCUMULATE_RATE"]},"fvrPolcAplyVal":{"type":"integer","description":"혜택정책적용값","format":"int64"},"fvrMinBuyAmt":{"type":"integer","description":"혜택최소구매금액","format":"int64"},"fvrMaxDcAmt":{"type":"integer","description":"혜택최대할인금액","format":"int64"},"entrChrgRate":{"type":"integer","description":"협력사분담율","format":"int32"},"entrChrgAmt":{"type":"integer","description":"협력사부담금액","format":"int64"},"ourChrgRate":{"type":"integer","description":"당사분담율","format":"int32"},"ourChrgAmt":{"type":"integer","description":"당사부담금액","format":"int64"},"promoNm":{"type":"string","description":"프로모션명"}},"description":"주문부가비용정보 DTO"},"OpOrdPayDivInfo":{"type":"object","properties":{"payDivSeq":{"type":"string","description":"결제배분순번"},"ordNo":{"type":"string","description":"주문번호"},"ordSeq":{"type":"integer","description":"주문순번","format":"int32"},"ordProcSeq":{"type":"integer","description":"주문처리순번","format":"int32"},"uprPayDivSeq":{"type":"string","description":"상위결제배분순번"},"divGbCd":{"type":"string","description":"배분구분코드(OM073)"},"adtnOcurGbCd":{"type":"string","description":"부가비용발생구분코드(OM017)"},"ordCostGbCd":{"type":"string","description":"주문비용구분코드(OM043)"},"deliPolcNo":{"type":"string","description":"배송비정책번호"},"entrNo":{"type":"string","description":"입점사번호"},"claimNo":{"type":"string","description":"클레임번호"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"cnclQty":{"type":"integer","description":"취소수량","format":"int32"},"ordAmt":{"type":"integer","description":"주문금액","format":"int64"},"crdtCardDivAmt":{"type":"integer","description":"신용카드배분금액","format":"int64"},"milgDivAmt":{"type":"integer","description":"포인트배분금액","format":"int64"},"rltmActnTrsfDivAmt":{"type":"integer","description":"실시간계좌이체배분금액","format":"int64"},"virActnTrsfDivAmt":{"type":"integer","description":"가상계좌이체배분금액","format":"int64"},"deliNo":{"type":"string","description":"배송번호"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"addPayYn":{"type":"string","description":"추가결제여부"},"itemNm":{"type":"string","description":"품목명"},"taxGbCdNm":{"type":"string","description":"과면세구분코드(PR007)"},"occurTaxFree":{"type":"boolean"},"cancelTaxFree":{"type":"boolean"},"addPayDeliFee":{"type":"boolean"}}},"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"}}}}
```
## 이니시스 PC 결제요청 파라미터 생성
> \## 기능설명\
> \* 이니시스 PC 결제요청할 때 필요한 파라미터를 생성하는 API입니다.\
> \---\
> \## 상세설명\
> \* timestamp, signature, verification, mKey를 생성합니다.
```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/getInicisPcAuthProperties":{"post":{"tags":["결제정보"],"summary":"이니시스 PC 결제요청 파라미터 생성","description":"## 기능설명\n* 이니시스 PC 결제요청할 때 필요한 파라미터를 생성하는 API입니다.\n---\n## 상세설명\n* timestamp, signature, verification, mKey를 생성합니다.\n","operationId":"getInicisPcAuthProperties","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InicisPcAuthRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InicisPcAuthResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"InicisPcAuthRequest":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"payAmt":{"type":"integer","description":"주문금액","format":"int64"}},"description":"이니시스 PC결제 인증 Parameter 생성용 DTO"},"InicisPcAuthResponse":{"type":"object","properties":{"timestamp":{"type":"string","description":"타임스템프 [TimeInMillis(Long형)]"},"signature":{"type":"string","description":"SHA256 Hash값(대상: oid, price, timestamp)"},"verification":{"type":"string","description":"SHA256 Hash값(대상: oid, price, signKey, timestamp)"},"mkey":{"type":"string"}},"description":"이니시스 PC 결제요청 변환 결과 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"}}}}
```
## 이니시스 MO 빌키발급요청 파라미터 생성
> \## 기능설명\
> \* 이니시스 MO 빌키발급요청할 때 필요한 파라미터를 생성하는 API입니다.\
> \---\
> \## 상세설명\
> \* timestamp, hashdata를 생성합니다.
```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/getInicisMoAuthProperties":{"post":{"tags":["결제정보"],"summary":"이니시스 MO 빌키발급요청 파라미터 생성","description":"## 기능설명\n* 이니시스 MO 빌키발급요청할 때 필요한 파라미터를 생성하는 API입니다.\n---\n## 상세설명\n* timestamp, hashdata를 생성합니다.\n","operationId":"getInicisMoAuthProperties","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InicisMoAuthRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/InicisMoAuthResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"InicisMoAuthRequest":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"termlId":{"type":"string","description":"터미널ID"}},"description":"이니시스 MO 빌키발급요청 Parameter 생성용 DTO"},"InicisMoAuthResponse":{"type":"object","properties":{"timestamp":{"type":"string","description":"타임스템프 [TimeInMillis(Long형)]"},"hashData":{"type":"string","description":"SHA256 Hash값(대상: mid, orderid, timestamp, INILitekey)"}},"description":"이니시스 MO 빌키발급요청 변환 결과 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"}}}}
```
## 무이자할부 안내 목록 조회
> \## 기능 설명\
> \* 신용카드의 무이자할부 안내 목록을 조회합니다.\
> \---\
> \## 상세 설명\
> \* BO의 주문/결제 > 결제수단 관리 > 무이자할부 안내 관리에서 등록한 데이터 조회
```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/getInterestFreeList":{"get":{"tags":["결제정보"],"summary":"무이자할부 안내 목록 조회","description":" ## 기능 설명\n * 신용카드의 무이자할부 안내 목록을 조회합니다.\n ---\n ## 상세 설명\n * BO의 주문/결제 > 결제수단 관리 > 무이자할부 안내 관리에서 등록한 데이터 조회\n","operationId":"getInterestFreeList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InterestFreeResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"InterestFreeResponse":{"type":"object","properties":{"nintInstGdNo":{"type":"string","description":"무이자할부안내번호"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrNm":{"type":"string","description":"매입사명"},"aplyStrDtm":{"type":"string","description":"적용시작일시"},"aplyEndDtm":{"type":"string","description":"적용종료일시"},"nintInstNm":{"type":"string","description":"무이자할부명"},"nintAplyTgtCont":{"type":"string","description":"무이자적용대상내용"},"nintExcpTgtCont":{"type":"string","description":"무이자제외대상내용"},"sctnNintYn":{"type":"string","description":"부분무이자여부"},"pgGbCd":{"type":"string","description":"pg구분코드(OM030)"},"pgGbNm":{"type":"string","description":"pg사명"},"monthList":{"type":"array","description":"개월 별 무이자 여부 리스트","items":{"$ref":"#/components/schemas/InterestFreeMonth"}}}},"InterestFreeMonth":{"type":"object","properties":{"tgtAmt":{"type":"number","description":"대상금액","format":"double"},"nint1MonYn":{"type":"string","description":"무이자1개월여부"},"nint2MonYn":{"type":"string","description":"무이자2개월여부"},"nint3MonYn":{"type":"string","description":"무이자3개월여부"},"nint4MonYn":{"type":"string","description":"무이자4개월여부"},"nint5MonYn":{"type":"string","description":"무이자5개월여부"},"nint6MonYn":{"type":"string","description":"무이자6개월여부"},"nint7MonYn":{"type":"string","description":"무이자7개월여부"},"nint8MonYn":{"type":"string","description":"무이자8개월여부"},"nint9MonYn":{"type":"string","description":"무이자9개월여부"},"nint10MonYn":{"type":"string","description":"무이자10개월여부"},"nint11MonYn":{"type":"string","description":"무이자11개월여부"},"nint12MonYn":{"type":"string","description":"무이자12개월여부"}},"description":"개월 별 무이자 여부 리스트"},"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"}}}}
```
## 계좌인증용 MID 조회
> \## 기능설명\
> \* 계좌인증 전용 MID를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 계좌인증용 MID를 조회합니다.
```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/accountCertiMid":{"get":{"tags":["결제정보"],"summary":"계좌인증용 MID 조회","description":"## 기능설명\n* 계좌인증 전용 MID를 조회하는 API입니다.\n---\n## 상세설명\n* 계좌인증용 MID를 조회합니다.\n","operationId":"getAcoountCertiMid","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"String"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"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"}}}}
```
---
# Agent Instructions: 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:
```
GET https://tech.x2bee.com/api/store-front-api/order-api/undefined-7.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.