# 자동결제카드관리
## 자동결제 카드 삭제
> \## 기능설명\
> 자동결제 카드를 삭제합니다.\
> \
\
\
> \---\
> \## 상세내용\
> \* 로그인시에만 제공되는 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"}}}}
```
---
# 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-3.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.