자동결제카드관리

자동결제 카드 삭제

put

기능설명

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

상세내용

로그인시에만 제공되는 API입니다.
정기 배송을 위해 등록된 자동결제 신용카드를 삭제합니다.
신용카드 삭제시에는 삭제여부값이 'Y'로 업데이트됩니다.
진행중인 정기주문 신청건이 있는경우 삭제가 불가합니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

자동결제 카드 요청 DTO

siteNostringOptional

사이트 번호

Example: 1

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

put/v1/autoPaymentCard/deleteCard

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

{
  "siteNo": "1",
  "orderInfo": {
    "ordNo": "20990101O000001",
    "claimNo": "20990101C000001",
    "goodsNm": "플래티어커피",
    "ordManNm": "김플래티어",
    "ordmnCellNo": "01012345678",
    "ordmnEmailAddr": "kim@plateer.com",
    "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

자동결제 카드 요청 DTO

siteNostringOptional

사이트 번호

Example: 1

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post/v1/autoPaymentCard/registerCard

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

{
  "siteNo": "1",
  "orderInfo": {
    "ordNo": "20990101O000001",
    "claimNo": "20990101C000001",
    "goodsNm": "플래티어커피",
    "ordManNm": "김플래티어",
    "ordmnCellNo": "01012345678",
    "ordmnEmailAddr": "kim@plateer.com",
    "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

GET /api/order/v1/autoPaymentCard/getCardInfo?request=[object+Object] HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*

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

이전장바구니

다음상품제공

마지막 업데이트 4개월 전