자동결제카드관리

자동결제 카드 삭제

put

기능설명

자동결제 카드를 삭제합니다.

상세내용

• 로그인시에만 제공되는 API입니다.

• 정기 배송을 위해 등록된 자동결제 신용카드를 삭제합니다.

• 신용카드 삭제시에는 삭제여부값이 'Y'로 업데이트됩니다.

• 진행중인 정기주문 신청건이 있는경우 삭제가 불가합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

자동결제 카드 요청 DTO

siteNostringOptional

사이트 번호

Example: 1

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

put

/v1/autoPaymentCard/deleteCard

HTTPcURLJavaScriptPython

PUT /api/order/v1/autoPaymentCard/deleteCard HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 716

{
  "siteNo": "1",
  "orderInfo": {
    "ordNo": "20990101O000001",
    "claimNo": "20990101C000001",
    "goodsNm": "플래티어커피",
    "ordManNm": "김플래티어",
    "ordmnCellNo": "01012345678",
    "ordmnEmailAddr": "[e-mail]",
    "crcUnitCd": "KRW",
    "ordMediaCd": "30",
    "mbrNo": "100000001",
    "ordDtlGbCd": "10",
    "clientIp": "127.0.0.1",
    "taxFreeAmt": 1
  },
  "payInfoList": [
    {
      "payNo": "1",
      "payWayCd": "11",
      "payAmt": 1000,
      "mersNo": "1",
      "pgGbCd": "10",
      "trdNo": "INIMX_DBNKINIpayTest20990101090000685510",
      "selectCardCd": "01",
      "termlId": "INIBillTst",
      "billKey": "text",
      "authResultMap": "{P_STATUS:결과코드, P_RMESG1:결과메시지, P_TID:인증거래번호, P_AMT:거래금액, idc_name:IDC센터코드P_REQ_URL:승인요청 URL, P_NOTI:가맹점 임의 데이터}"
    }
  ]
}

No content

자동결제 카드 등록/수정

post

기능설명

자동결제 카드를 등록 및 변경합니다.

상세내용

• 로그인시에만 제공되는 API입니다.

• 주문정보의 주문매체코드(OM007)값은 필수값입니다.

• 결제정보의 PG 구분코드(OM030)값은 필수값입니다.

• 결제 수단(OM013, 결제수단코드)이 '신용카드(11)'이고, PG 구분(OM030, PG 구분코드)이 '이니시스(10)/토스(20)'인 경우에만 정상 처리됩니다.

• 주문매체가 'PC' 인 경우 추가적으로 이니시스에 빌링키 발급을 요청합니다.

• 이니시스 빌링키 발급 요청 결과 수신된 빌링키와 카드 코드를 기반으로 신용카드 정보를 등록합니다.

• 카드 변경시에는 기존에 등록된 카드 삭제 처리 후 새로 등록한 카드 정보를 저장합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

자동결제 카드 요청 DTO

siteNostringOptional

사이트 번호

Example: 1

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/autoPaymentCard/registerCard

HTTPcURLJavaScriptPython

POST /api/order/v1/autoPaymentCard/registerCard HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 716

{
  "siteNo": "1",
  "orderInfo": {
    "ordNo": "20990101O000001",
    "claimNo": "20990101C000001",
    "goodsNm": "플래티어커피",
    "ordManNm": "김플래티어",
    "ordmnCellNo": "01012345678",
    "ordmnEmailAddr": "[e-mail]",
    "crcUnitCd": "KRW",
    "ordMediaCd": "30",
    "mbrNo": "100000001",
    "ordDtlGbCd": "10",
    "clientIp": "127.0.0.1",
    "taxFreeAmt": 1
  },
  "payInfoList": [
    {
      "payNo": "1",
      "payWayCd": "11",
      "payAmt": 1000,
      "mersNo": "1",
      "pgGbCd": "10",
      "trdNo": "INIMX_DBNKINIpayTest20990101090000685510",
      "selectCardCd": "01",
      "termlId": "INIBillTst",
      "billKey": "text",
      "authResultMap": "{P_STATUS:결과코드, P_RMESG1:결과메시지, P_TID:인증거래번호, P_AMT:거래금액, idc_name:IDC센터코드P_REQ_URL:승인요청 URL, P_NOTI:가맹점 임의 데이터}"
    }
  ]
}

No content

자동결제 카드 정보 조회

get

기능설명

자동결제 카드 정보를 조회합니다.

상세내용

• 로그인시에만 제공되는 API입니다.

• 로그인한 사용자에 한해, 기등록된 자동결제 신용카드 정보를 조회합니다.

• 회원번호(mbrNo)를 기준으로 삭제 처리되지 않고 적용기간이 유효한 신용카드를 조회합니다.

• 등록된 신용카드 정보가 없는 경우, 자동결제 신용카드 등록시 필요한 회원정보 및 임의 생성된 주문번호를 내려줍니다.

---

수정 번호

• Release v2.00_240627: 자동결제카드 조회에 사이트번호 추가

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

자동결제 카드 응답 DTO

900

업무처리 오류 내용

*/*

get

/v1/autoPaymentCard/getCardInfo

HTTPcURLJavaScriptPython

GET /api/order/v1/autoPaymentCard/getCardInfo?request=[object+Object] HTTP/1.1
Host: localhost:8092/
Accept: */*

{
  "cardInfo": {
    "siteNo": "1",
    "mbrNo": "100000001",
    "aplyStrDtm": "2026-02-27T19:43:07.758Z",
    "aplyEndDtm": "2026-02-27T19:43:07.758Z",
    "pgGbCd": "10",
    "pgGbCdNm": "이니시스(INICIS)",
    "acqrCd": "102",
    "acqrCdNm": "삼성카드",
    "cardNo": "123456*********7",
    "bllgKeyNo": "371837374a8dcc1f8a04c15c802dfc40954cf5e7",
    "bllgKeyRegDtm": "2026-02-27T19:43:07.758Z",
    "delYn": "N"
  }
}