> 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-3.md).
# 자동결제카드관리
## 자동결제 카드 삭제
> \## 기능설명\
> 자동결제 카드를 삭제합니다.\
> \
\
\
> \---\
> \## 상세내용\
> \* 로그인시에만 제공되는 API입니다.\
\
\
> \* 정기 배송을 위해 등록된 자동결제 신용카드를 삭제합니다.\
\
\
> \* 신용카드 삭제시에는 삭제여부값이 'Y'로 업데이트됩니다.\
\
\
> \* 진행중인 정기주문 신청건이 있는경우 삭제가 불가합니다.\
\
```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/autoPaymentCard/deleteCard":{"put":{"tags":["자동결제카드관리"],"summary":"자동결제 카드 삭제","description":"## 기능설명\n자동결제 카드를 삭제합니다.\n
\n---\n## 상세내용\n* 로그인시에만 제공되는 API입니다.
\n* 정기 배송을 위해 등록된 자동결제 신용카드를 삭제합니다.
\n* 신용카드 삭제시에는 삭제여부값이 'Y'로 업데이트됩니다.
\n* 진행중인 정기주문 신청건이 있는경우 삭제가 불가합니다.
\n","operationId":"deleteCard","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoPaymentCardRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"AutoPaymentCardRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"orderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"payInfoList":{"type":"array","description":"결제를 요청하는 주문/클레임 DTO","items":{"$ref":"#/components/schemas/PaymentInfo"}}},"description":"자동결제 카드 요청 DTO"},"PaymentOrderInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"goodsNm":{"type":"string","description":"상품명"},"ordManNm":{"type":"string","description":"주문자명"},"ordmnCellNo":{"type":"string","description":"주문자휴대폰번호"},"ordmnEmailAddr":{"type":"string","description":"주문자이메일주소"},"crcUnitCd":{"type":"string","description":"통화단위코드"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"mbrNo":{"type":"string","description":"회원번호"},"ordDtlGbCd":{"type":"string","description":"주문내역상세구분코드(OM003)"},"clientIp":{"type":"string","description":"클라이언트IP"},"taxFreeAmt":{"type":"integer","description":"면세 금액","format":"int64"}},"description":"결제에 필요한 주문 DTO"},"PaymentInfo":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"mersNo":{"type":"string","description":"가맹점번호"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"trdNo":{"type":"string","description":"거래번호(tid)"},"selectCardCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"termlId":{"type":"string","description":"터미널ID(mid)"},"billKey":{"type":"string","description":"승인요청할 빌링키 값"},"authResultMap":{"type":"object","additionalProperties":{"type":"string","description":"인증결과정보"},"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"}}}}
```
## 자동결제 카드 등록/수정
> \## 기능설명\
> 자동결제 카드를 등록 및 변경합니다.\
> \
\
\
> \---\
> \## 상세내용\
> \* 로그인시에만 제공되는 API입니다.\
\
\
> \* 주문정보의 주문매체코드(OM007)값은 필수값입니다.\
\
\
> \* 결제정보의 PG 구분코드(OM030)값은 필수값입니다.\
\
\
> \* 결제 수단(OM013, 결제수단코드)이 '신용카드(11)'이고, PG 구분(OM030, PG 구분코드)이 '이니시스(10)/토스(20)'인 경우에만 정상 처리됩니다.\
\
\
> \* 주문매체가 'PC' 인 경우 추가적으로 이니시스에 빌링키 발급을 요청합니다.\
\
\
> \* 이니시스 빌링키 발급 요청 결과 수신된 빌링키와 카드 코드를 기반으로 신용카드 정보를 등록합니다.\
\
\
> \* 카드 변경시에는 기존에 등록된 카드 삭제 처리 후 새로 등록한 카드 정보를 저장합니다.\
\
```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/autoPaymentCard/registerCard":{"post":{"tags":["자동결제카드관리"],"summary":"자동결제 카드 등록/수정","description":"## 기능설명\n자동결제 카드를 등록 및 변경합니다.\n
\n---\n## 상세내용\n* 로그인시에만 제공되는 API입니다.
\n* 주문정보의 주문매체코드(OM007)값은 필수값입니다.
\n* 결제정보의 PG 구분코드(OM030)값은 필수값입니다.
\n* 결제 수단(OM013, 결제수단코드)이 '신용카드(11)'이고, PG 구분(OM030, PG 구분코드)이 '이니시스(10)/토스(20)'인 경우에만 정상 처리됩니다.
\n* 주문매체가 'PC' 인 경우 추가적으로 이니시스에 빌링키 발급을 요청합니다.
\n* 이니시스 빌링키 발급 요청 결과 수신된 빌링키와 카드 코드를 기반으로 신용카드 정보를 등록합니다.
\n* 카드 변경시에는 기존에 등록된 카드 삭제 처리 후 새로 등록한 카드 정보를 저장합니다.
\n","operationId":"registerCard","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoPaymentCardRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"AutoPaymentCardRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"orderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"payInfoList":{"type":"array","description":"결제를 요청하는 주문/클레임 DTO","items":{"$ref":"#/components/schemas/PaymentInfo"}}},"description":"자동결제 카드 요청 DTO"},"PaymentOrderInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"goodsNm":{"type":"string","description":"상품명"},"ordManNm":{"type":"string","description":"주문자명"},"ordmnCellNo":{"type":"string","description":"주문자휴대폰번호"},"ordmnEmailAddr":{"type":"string","description":"주문자이메일주소"},"crcUnitCd":{"type":"string","description":"통화단위코드"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"mbrNo":{"type":"string","description":"회원번호"},"ordDtlGbCd":{"type":"string","description":"주문내역상세구분코드(OM003)"},"clientIp":{"type":"string","description":"클라이언트IP"},"taxFreeAmt":{"type":"integer","description":"면세 금액","format":"int64"}},"description":"결제에 필요한 주문 DTO"},"PaymentInfo":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"mersNo":{"type":"string","description":"가맹점번호"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"trdNo":{"type":"string","description":"거래번호(tid)"},"selectCardCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"termlId":{"type":"string","description":"터미널ID(mid)"},"billKey":{"type":"string","description":"승인요청할 빌링키 값"},"authResultMap":{"type":"object","additionalProperties":{"type":"string","description":"인증결과정보"},"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"}}}}
```
## 자동결제 카드 정보 조회
> \## 기능설명\
> 자동결제 카드 정보를 조회합니다.\
> \
\
\
> \---\
> \## 상세내용\
> \* 로그인시에만 제공되는 API입니다.\
\
\
> \* 로그인한 사용자에 한해, 기등록된 자동결제 신용카드 정보를 조회합니다.\
\
\
> \* 회원번호(mbrNo)를 기준으로 삭제 처리되지 않고 적용기간이 유효한 신용카드를 조회합니다.\
\
\
> \* 등록된 신용카드 정보가 없는 경우, 자동결제 신용카드 등록시 필요한 회원정보 및 임의 생성된 주문번호를 내려줍니다.\
\
\
> \---\
> \## 수정 번호\
> \* 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/autoPaymentCard/getCardInfo":{"get":{"tags":["자동결제카드관리"],"summary":"자동결제 카드 정보 조회","description":"## 기능설명\n자동결제 카드 정보를 조회합니다.\n
\n---\n## 상세내용\n* 로그인시에만 제공되는 API입니다.
\n* 로그인한 사용자에 한해, 기등록된 자동결제 신용카드 정보를 조회합니다.
\n* 회원번호(mbrNo)를 기준으로 삭제 처리되지 않고 적용기간이 유효한 신용카드를 조회합니다.
\n* 등록된 신용카드 정보가 없는 경우, 자동결제 신용카드 등록시 필요한 회원정보 및 임의 생성된 주문번호를 내려줍니다.
\n---\n## 수정 번호\n* Release v2.00_240627: 자동결제카드 조회에 사이트번호 추가\n","operationId":"getCardInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AutoPaymentCardRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AutoPaymentCardResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"AutoPaymentCardRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"orderInfo":{"$ref":"#/components/schemas/PaymentOrderInfo"},"payInfoList":{"type":"array","description":"결제를 요청하는 주문/클레임 DTO","items":{"$ref":"#/components/schemas/PaymentInfo"}}},"description":"자동결제 카드 요청 DTO"},"PaymentOrderInfo":{"type":"object","properties":{"ordNo":{"type":"string","description":"주문번호"},"claimNo":{"type":"string","description":"클레임번호"},"goodsNm":{"type":"string","description":"상품명"},"ordManNm":{"type":"string","description":"주문자명"},"ordmnCellNo":{"type":"string","description":"주문자휴대폰번호"},"ordmnEmailAddr":{"type":"string","description":"주문자이메일주소"},"crcUnitCd":{"type":"string","description":"통화단위코드"},"ordMediaCd":{"type":"string","description":"주문매체코드(OM007)"},"mbrNo":{"type":"string","description":"회원번호"},"ordDtlGbCd":{"type":"string","description":"주문내역상세구분코드(OM003)"},"clientIp":{"type":"string","description":"클라이언트IP"},"taxFreeAmt":{"type":"integer","description":"면세 금액","format":"int64"}},"description":"결제에 필요한 주문 DTO"},"PaymentInfo":{"type":"object","properties":{"payNo":{"type":"string","description":"결제번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payAmt":{"type":"integer","description":"결제금액","format":"int64"},"mersNo":{"type":"string","description":"가맹점번호"},"pgGbCd":{"type":"string","description":"PG구분코드(OM030)"},"trdNo":{"type":"string","description":"거래번호(tid)"},"selectCardCd":{"type":"string","description":"결제요청카드사코드(OM057)"},"termlId":{"type":"string","description":"터미널ID(mid)"},"billKey":{"type":"string","description":"승인요청할 빌링키 값"},"authResultMap":{"type":"object","additionalProperties":{"type":"string","description":"인증결과정보"},"description":"인증결과정보"}},"description":"결제 DTO"},"AutoPaymentCardResponse":{"type":"object","properties":{"cardInfo":{"$ref":"#/components/schemas/OpMbrAutoPayInfo"}},"description":"자동결제 카드 응답 DTO","nullable":true},"OpMbrAutoPayInfo":{"type":"object","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"mbrNo":{"type":"string","description":"고객번호"},"aplyStrDtm":{"type":"string","description":"적용시작일시","format":"date-time"},"aplyEndDtm":{"type":"string","description":"적용종료일시","format":"date-time"},"pgGbCd":{"type":"string","description":"OM030(PG구분코드)\n 10: 이니시스(INICIS)\n,20: 토스(TOSS)\n","enum":["INICIS","TOSS"]},"pgGbCdNm":{"type":"string","description":"PG구분코드명(OM030)"},"acqrCd":{"type":"string","description":"매입사코드(OM028)"},"acqrCdNm":{"type":"string","description":"매입사코드명(OM028)"},"cardNo":{"type":"string","description":"카드번호"},"bllgKeyNo":{"type":"string","description":"빌링키번호"},"bllgKeyRegDtm":{"type":"string","description":"빌링키등록일시","format":"date-time"},"delYn":{"type":"string","description":"삭제여부"}},"description":"회원자동결제정보","nullable":true},"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"}}}}
```