> 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/store-front-api/order-api/undefined-7.md).
# 결제정보
## 마일리지 환불 처리
> \## 기능 설명\
> \* \[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"}}}}
```