BC OPEN API 명세서 (ver 1.0)

Download OpenAPI specification:Download

1. 카드회원 가입 및 등록

신청발급구분(신규/재발급/갱신) 별 카드 회원 정보를 등록하거나 신청한 카드 정보를 정정/취소 하는 업무입니다.

신규 카드 회원 등록

개인회원이 최초 혹은 추가로 본인 체크카드를 신청하기 위해 회원 및 카드 정보를 등록합니다.

Request Body schema: application/json;charset=UTF-8
required

사용자정보

bkBrNo
required
string = 7 characters
Default: "0500001"

영업점 관리 번호

aplcClss
required
string = 2 characters
Default: "11"

신청발급구분 (11:신규, 12:추가신규)

hgNm
required
string <= 18 characters
Default: "김비씨"

한글성명

engNm
required
string <= 25 characters
Default: "KIM BC"

영문성명

juminNo
required
string = 32 characters
Default: "9660811061305F7F653128528C7B06EE"

주민등록번호(SEED), 샘플 주민등록번호:8010102222222

sex
required
string = 1 characters
Default: "1"

성별 (1:남자 2:여자)

frnPsnClss
required
string = 1 characters
Default: "2"

외국인구분 (2:내국인, 3:외국인(주민등록번호 재접수))

pswdNo
required
string = 32 characters
Default: "16CDB504A4B6245715AD01A591F91A02"

비밀번호(SEED), 샘플 비밀번호:1234

homeZpNo
required
string = 5 characters
Default: "04548"

[신주소] 5자리 우편번호

homeAddr
required
string <= 70 characters
Default: "서울 중구 을지로 170"

[신주소] 도로명주소

homeNwAddr2
required
string <= 100 characters
Default: "비씨카드(을지로4가, 을지트윈타워)"

[신주소] 상세주소, 허용 특수문자 :KSC5601코드 및 ( "-", ".", "/", "@", "(", ")" )

homeRoadCode
required
string <= 25 characters
Default: "1114031010060600017000000"

[신주소] 도로명참조코드

hpNo1
required
string = 4 characters
Default: "010"

핸드폰번호(지역)

hpNo2
required
string = 4 characters
Default: "0000"

핸드폰번호(국)

hpNo3
required
string = 4 characters
Default: "0000"

핸드폰번호(번)

affiFirmNo
required
string = 6 characters
Default: "100001"

제휴업체번호(상품코드)

aplcCardNo
required
string = 16 characters
Default: "9400501111111111"

신청카드번호

reqValdLim
required
string = 6 characters
Default: "202903"

요청유효기간, 미입력시 신청일 기준 +5년 원칙

brllCardDvCd
required
string = 1 characters
Default: ""

점자카드구분코드 (1:점자카드)

brllAdvDvCd
required
string = 1 characters
Default: ""

점자안내문구분코드 (1:점자안내문)

eadmin
string <= 300 characters
Default: ""

발급사개별영역(문의시 상세내용 별도 송부)

infoGdsGthrCnstYn
string = 1 characters
Default: "1"

정보제공동의여부[수집_카드상품] (1:동의, 9:미동의)

spInfoPdctGthrAgriYn
string = 1 characters
Default: "1"

정보제공동의여부_수집_카드상품_고유식별번호(1:동의 9:미동의)

infoSvcGthrCnstYn
string = 1 characters
Default: "1"

정보제공동의여부[수집_부수서비스] (1:동의, 9:미동의)

spInfoSvcGthrAgriYn
string = 1 characters
Default: ""

정보제공동의여부_수집_부수서비스_고유식별번호(1:동의 9:미동의)

infoFrauUseSppyCnstYn
string = 1 characters
Default: ""

정보제공동의여부[제공_부정사용방지] (1:동의, 9:미동의)

spInfoFrauUseSupAgriYn
string = 1 characters
Default: "1"

정보제공동의여부_제공_부정사용방지_고유식별번호(1:동의 9:미동의)

cardDsnClss
string = 1 characters
Default: "A"

카드디자인구분(협의)

sndAddrClss
string = 1 characters
Default: "1"

카드발송지 주소구분 (1:자택, '1'외 협의)

ownDlvClss
string = 1 characters
Default: "1"

본인배송여부 (1:ONLY본인배송, NULL:기존과동일)

sndTp
string = 1 characters
Default: "1"

발송유형 (1:본인수령 2:관리영업점송부 3:제3영업점송부 4:본인특송 5:가족배송 7:별도배송)

sndBkBrNo
string = 7 characters
Default: ""

발송영업점번호

cvsDlvBuzNo
string = 12 characters
Default: ""

편의점배송사업장번호(협의)

affiCdhdId
string = 19 characters
Default: ""

제휴회원ID(협의)

aplcChnlAcctNo
string = 24 characters
Default: "100000000000000"

간편결제 사업자 (100000000000000 : 삼성페이, 010000000000000: 카카오페이 등, 문의 시 상세 내역 별도 송부)

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "bkBrNo": "0500001",
  • "aplcClss": "11",
  • "hgNm": "김비씨",
  • "engNm": "KIM BC",
  • "juminNo": "9660811061305F7F653128528C7B06EE",
  • "sex": "1",
  • "frnPsnClss": "2",
  • "pswdNo": "16CDB504A4B6245715AD01A591F91A02",
  • "homeZpNo": "04548",
  • "homeAddr": "서울 중구 을지로 170",
  • "homeNwAddr2": "비씨카드(을지로4가, 을지트윈타워)",
  • "homeRoadCode": "1114031010060600017000000",
  • "hpNo1": "010",
  • "hpNo2": "0000",
  • "hpNo3": "0000",
  • "affiFirmNo": "100001",
  • "aplcCardNo": "9400501111111111",
  • "reqValdLim": "202903",
  • "brllCardDvCd": "",
  • "brllAdvDvCd": "",
  • "eadmin": "",
  • "infoGdsGthrCnstYn": "1",
  • "spInfoPdctGthrAgriYn": "1",
  • "infoSvcGthrCnstYn": "1",
  • "spInfoSvcGthrAgriYn": "",
  • "infoFrauUseSppyCnstYn": "",
  • "spInfoFrauUseSupAgriYn": "1",
  • "cardDsnClss": "A",
  • "sndAddrClss": "1",
  • "ownDlvClss": "1",
  • "sndTp": "1",
  • "sndBkBrNo": "",
  • "cvsDlvBuzNo": "",
  • "affiCdhdId": "",
  • "aplcChnlAcctNo": "100000000000000"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

재발급 카드 회원 등록

개인회원이 훼손 및 분실 등의 사유로, 카드를 재발급하기 위해 회원 및 카드 정보를 등록합니다.

Request Body schema: application/json;charset=UTF-8
required

사용자정보

bkBrNo
required
string = 7 characters
Default: "0500001"

영업점관리번호

aplcClss
required
string = 2 characters
Default: "21"

신청발급구분 (21:훼손재발급, 24:분실재발급, 31:일반갱신, 33:자동갱신, 37:지연갱신(갱신 운영시 상세협의))

curCardNo
required
string = 16 characters
Default: "9400501111111111"

현카드번호

aplcCardNo
required
string = 16 characters
Default: "9400502222222222"

신청카드번호

reqValdLim
required
string = 6 characters
Default: "202903"

요청유효기한

pswdNo
required
string = 32 characters
Default: "16CDB504A4B6245715AD01A591F91A02"

비밀번호(SEED), 샘플 비밀번호:1234

affiFirmNo
required
string = 6 characters
Default: "100001"

제휴업체번호(상품코드)

engNm
string <= 25 characters
Default: "KIM BC"

영문성명

eadmin
string <= 300 characters
Default: ""

발급사개별영역(문의시 상세내용 별도 송부)

cardDsnClss
string = 1 characters
Default: "A"

카드디자인구분(협의)

sndAddrClss
string = 1 characters
Default: "1"

카드발송지 주소구분 (1:자택, '1'외 협의)

ownDlvClss
string = 1 characters
Default: ""

본인배송여부 (1:ONLY본인배송, NULL:기존과동일)

sndTp
string = 1 characters
Default: "1"

발송유형 (1:본인수령 2:관리영업점송부 3:제3영업점송부 4:본인특송 5:가족배송 7:별도배송)

sndBkBrNo
string = 7 characters
Default: ""

발송영업점번호

cvsDlvBuzNo
string <= 12 characters
Default: ""

편의점배송사업장번호(협의)

aplcChnlAcctNo
string = 24 characters
Default: "100000000000000"

간편결제 사업자 (100000000000000 : 삼성페이, 010000000000000: 카카오페이 등, 문의 시 상세 내역 별도 송부)

brllAdvDvCd
string = 1 characters
Default: ""

점자안내문구분코드 (1:점자안내문)

brllCardDvCd
string = 1 characters
Default: ""

점자카드구분코드 (1:점자카드)

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "bkBrNo": "0500001",
  • "aplcClss": "21",
  • "curCardNo": "9400501111111111",
  • "aplcCardNo": "9400502222222222",
  • "reqValdLim": "202903",
  • "pswdNo": "16CDB504A4B6245715AD01A591F91A02",
  • "affiFirmNo": "100001",
  • "engNm": "KIM BC",
  • "eadmin": "",
  • "cardDsnClss": "A",
  • "sndAddrClss": "1",
  • "ownDlvClss": "",
  • "sndTp": "1",
  • "sndBkBrNo": "",
  • "cvsDlvBuzNo": "",
  • "aplcChnlAcctNo": "100000000000000",
  • "brllAdvDvCd": "",
  • "brllCardDvCd": ""
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

카드 신청정보 정정

개인회원이 당일 신청한 카드에 한해서 일부 정보를 정정합니다.
카드 신청 당일 23:59:59까지 정정이 가능합니다.

Request Body schema: application/json;charset=UTF-8
required

사용자정보

bkBrNo
required
string = 7 characters
Default: "0500001"

영업점관리번호

aplcClss
required
string = 2 characters
Default: "11"

신청발급구분(11:신규, 12:추가신규, 21:훼손재발급,
24:분실재발급, 31:일반갱신, 33:자동갱신, 37:지연갱신)

aplcCardNo
required
string = 16 characters
Default: "9400501111111111"

신청카드번호

engNm
string <= 25 characters
Default: "GIM B C"

영문성명

sndAddrClss
string = 1 characters
Default: ""

카드발송지 주소구분 (1:자택, '1'외 협의)

cardDsnClss
string = 1 characters
Default: "B"

카드디자인구분(협의)

ownDlvClss
string = 1 characters
Default: ""

본인배송여부 (1:ONLY본인배송, NULL:기존과동일)

sndTp
string = 1 characters
Default: ""

발송유형 (1:본인수령 2:관리영업점송부 3:제3영업점송부 4:본인특송 5:가족배송 7:별도배송)

sndBkBrNo
string = 7 characters
Default: ""

발송영업점번호

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "bkBrNo": "0500001",
  • "aplcClss": "11",
  • "aplcCardNo": "9400501111111111",
  • "engNm": "GIM B C",
  • "sndAddrClss": "",
  • "cardDsnClss": "B",
  • "ownDlvClss": "",
  • "sndTp": "",
  • "sndBkBrNo": ""
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

카드 신청 취소

개인 회원이 당일 신청한 카드를 취소합니다.
카드 신청 당일 23:59:59 까지 취소가 가능합니다.

Request Body schema: application/json;charset=UTF-8
required

사용자정보

bkBrNo
required
string = 7 characters
Default: "0500001"

영업점관리번호

aplcClss
required
string = 2 characters
Default: "11"

신청발급구분 (11:신규, 12:추가신규, 21:훼손재발급, 24:분실재발급, 31:일반갱신, 33:자동갱신, 37:지연갱신)

aplcCardNo
required
string = 16 characters
Default: "9400501111111111"

신청카드번호

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "bkBrNo": "0500001",
  • "aplcClss": "11",
  • "aplcCardNo": "9400501111111111"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

2. 카드발송

개인 회원 체크카드의 카드 발송 및 배송 관련 정보를 제공하는 업무입니다.

카드 발송 내역 조회

일자별로 카드의 발송 내역을 조회합니다.

Request Body schema: application/json;charset=UTF-8
required
fileDate
required
string = 8 characters
Default: "20240722"

자료작성일자

nextKey
required
string <= 19 characters
Default: "0"

NEXTKEY (최초 0, 이후 19자리 NEXTKEY)

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "fileDate": "20240722",
  • "nextKey": "0"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

카드 배송 현황 조회

발송 카드번호 기준으로, 배송 현황 상세 내역을 조회합니다.

Request Body schema: application/json;charset=UTF-8
required
cardNo
required
string <= 19 characters
Default: "9400111111111123"

카드번호

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "cardNo": "9400111111111123"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

카드 수령 결과

고객사가 BC카드로부터, 회원이 수령한 카드에 대한 정보를 실시간으로 수신 받습니다
※요청거래방향: BC카드 -> 고객사

Request Body schema: application/json;charset=UTF-8
required

사용자정보

sndCnt
string = 2 characters
Default: "01"

전송건수

sndDate
string = 8 characters
Default: "20240521"

카드발송일자

rcvDate
string = 8 characters
Default: "20240523"

카드수령일자

firmCd
string = 1 characters
Default: "G"

배송업체코드 (A:국제본인, B:국제영업점, C:제니엘본인, D:제니엘영업점, 문의 시 상세 내역 별도 송부)

rcvrNm
string <= 40 characters
Default: "김비씨"

수령인성명

rcvrCd
string = 2 characters
Default: "01"

카드수령관계코드 (01:본인, 문의 시 상세 내역 별도 송부)

regdNo
string <= 13 characters
Default: "6891234567890"

우편등기번호 (협의)

Array of objects (CardDeliveryResult_Item)

배열

sndNo
string = 8 characters
Default: "25671102"

발송번호 (비씨카드 채번 번호)

sndMsnoRsonCd
string = 1 characters
Default: ""

발송결번사유코드 (1:본인수령, 2:은행본점송부, 3:내방수령, 4:발급오류, 문의 시 상세 내역 별도 송부)

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "sndCnt": "01",
  • "sndDate": "20240521",
  • "rcvDate": "20240523",
  • "firmCd": "G",
  • "rcvrNm": "김비씨",
  • "rcvrCd": "01",
  • "regdNo": "6891234567890",
  • "array": [
    ],
  • "sndNo": "25671102",
  • "sndMsnoRsonCd": ""
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

카드 반송/입고/폐기 내역 조회

일자별로 카드의 반송, 입고, 폐기 내역을 조회합니다.

Request Body schema: application/json;charset=UTF-8
required
fileDate
required
string = 8 characters
Default: "20240722"

자료작성일자

dataDv
required
string = 1 characters
Default: "9"

데이터 구분 (2:반송, 4:폐기, 5:입고, 9:반송+폐기+입고)

nextKey
required
string <= 19 characters
Default: "0"

NEXTKEY (최초 0, 이후 19자리 nextKey)

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "fileDate": "20240722",
  • "dataDv": "9",
  • "nextKey": "0"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

3. 회원 관리

회원의 정보 제신고 및 관리를 위한 업무입니다.

회원 정보 제신고

휴대폰번호,주소 등 개인카드 회원의 정보를 제신고 합니다.

Request Body schema: application/json;charset=UTF-8
required

사용자정보

bkBrNo
required
string = 7 characters
Default: "0500001"

영업점관리번호

curCardNo
required
string = 16 characters
Default: "9400501111111111"

현카드번호

affiFirmNo
required
string <= 6 characters
Default: "100001"

제휴업체번호(상품코드)

hgNm
string <= 18 characters
Default: "김비씨"

한글성명

juminNo
string <= 32 characters
Default: "9660811061305F7F653128528C7B06EE"

주민등록번호(SEED), 샘플 주민등록번호:8010102222222

sex
string <= 1 characters
Default: "1"

성별 (1:남자 2:여자)

frnPsnClss
string <= 1 characters
Default: "2"

외국인구분 (2:내국인, 3:외국인(주민등록번호 재접수))

pswdNo
string <= 32 characters
Default: "16CDB504A4B6245715AD01A591F91A02"

비밀번호(SEED), 샘플 비밀번호:1234

homeZpNo
string <= 5 characters
Default: "04548"

[신주소] 5자리 우편번호

homeAddr
string <= 70 characters
Default: "서울 중구 을지로 170"

[신주소] 도로명주소

homeNwAddr2
string <= 100 characters
Default: "비씨카드(을지로4가, 을지트윈타워)"

[신주소] 상세주소, 허용 특수문자 : KSC5601코드 및 허용한 특수문자( "-", ".", "/", "@", "(", ")" )

homeRoadCode
string <= 25 characters
Default: "1114031010060600017000000"

[신주소] 도로명참조코드

hpNo1
string <= 4 characters
Default: "010"

핸드폰번호(지역)

hpNo2
string <= 4 characters
Default: "1111"

핸드폰번호(국)

hpNo3
string <= 4 characters
Default: "1111"

핸드폰번호(번)

infoGdsGthrCnstYn
string <= 1 characters
Default: "1"

정보제공동의여부[수집_카드상품] (1:동의, 9:미동의)

spInfoPdctGthrAgriYn
string <= 1 characters
Default: "1"

정보제공동의여부_수집_카드상품_고유식별번호 (1:동의 9:미동의)

infoSvcGthrCnstYn
string <= 1 characters
Default: "1"

정보제공동의여부[수집_부수서비스] (1:동의, 9:미동의)

spInfoSvcGthrAgriYn
string <= 1 characters
Default: "1"

정보제공동의여부_수집_부수서비스_고유식별번호 (1:동의 9:미동의)

infoFrauUseSppyCnstYn
string <= 1 characters
Default: "1"

정보제공동의여부[제공_부정사용방지] (1:동의, 9:미동의)

spInfoFrauUseSupAgriYn
string <= 1 characters
Default: "1"

정보제공동의여부_제공_부정사용방지_고유식별번호 (1:동의 9:미동의)

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "bkBrNo": "0500001",
  • "curCardNo": "9400501111111111",
  • "affiFirmNo": "100001",
  • "hgNm": "김비씨",
  • "juminNo": "9660811061305F7F653128528C7B06EE",
  • "sex": "1",
  • "frnPsnClss": "2",
  • "pswdNo": "16CDB504A4B6245715AD01A591F91A02",
  • "homeZpNo": "04548",
  • "homeAddr": "서울 중구 을지로 170",
  • "homeNwAddr2": "비씨카드(을지로4가, 을지트윈타워)",
  • "homeRoadCode": "1114031010060600017000000",
  • "hpNo1": "010",
  • "hpNo2": "1111",
  • "hpNo3": "1111",
  • "infoGdsGthrCnstYn": "1",
  • "spInfoPdctGthrAgriYn": "1",
  • "infoSvcGthrCnstYn": "1",
  • "spInfoSvcGthrAgriYn": "1",
  • "infoFrauUseSppyCnstYn": "1",
  • "spInfoFrauUseSupAgriYn": "1"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

보유카드 목록 조회

개인 회원이 보유한 카드 목록을 조회 합니다.

Request Body schema: application/json;charset=UTF-8
required
subjClss
required
string = 1 characters
Default: "1"

주체구분 (1:주민등록번호, 3:카드번호)

subjNo
required
string <= 32 characters
Default: "9660811061305F7F653128528C7B06EE"

주체번호 (주민등록번호(SEED)/카드번호)

searchClss
required
string = 1 characters
Default: "0"

조회구분 (0:전체, 1:(본인)재발급대상, 6:당일발급카드-후발급 카드 등록 취소 할 때 사용 가능)

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "subjClss": "1",
  • "subjNo": "9660811061305F7F653128528C7B06EE",
  • "searchClss": "0"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

비밀번호 오류 해지

카드 비밀번호의 오류 횟수를 해지 및 초기화 합니다.

Request Body schema: application/json;charset=UTF-8
required
cardNo
required
string = 16 characters
Default: "9400501111111111"

카드번호

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "cardNo": "9400501111111111"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

4. 사고자 등해제

고객사 및 BC로 인입된 회원의 사고를 처리하는 업무입니다.

고객사 사고자 등해제

고객사에서 회원의 사고를 등재 및 해제 요청 합니다.

Request Body schema: application/json;charset=UTF-8
required

사고자 등록 요청 코드

subjNo
required
string <= 19 characters
Default: "9400501111111111"

주체번호 (등록하려는 카드번호)

subjClss
required
string = 1 characters
Default: "2"

주체구분 (2:카드번호)

regAcciCode
required
string = 4 characters
Default: "0111"

사고코드: 사고유형번호[3]+등해제구분자[1](1:등재, 9:해제)
*대표코드 - 0069:사용등록개시, 0111:분실도난등록, 0119:분실도난해제, 0811:카드해지

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "subjNo": "9400501111111111",
  • "subjClss": "2",
  • "regAcciCode": "0111"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

BC 사고자 등해제

BC카드에 접수된 회원의 사고 정보를 고객사에 통보합니다.
※요청거래방향: BC카드 -> 고객사

Request Body schema: application/json;charset=UTF-8
required

사용자정보

subjNo
string <= 19 characters
Default: "9400501111111111"

주체번호 (등록하려는 카드번호)

subjClss
string <= 1 characters
Default: "2"

주체구분 (2:카드번호)

regAcciCode
string <= 4 characters
Default: "0111"

사고코드: 사고유형번호[3]+등해제구분자[1](1:등재, 9:해제)
*대표코드 - 0069:사용등록개시, 0111:분실도난등록, 0119:분실도난해제, 0811:카드해지

recDate
string <= 8 characters
Default: "20240516"

BC카드 사고 등재일자

recTime
string <= 6 characters
Default: "151031"

BC카드 사고 등재시간

receNo
string <= 6 characters
Default: "1"

접수번호 (BC카드 채번 사고 접수번호)

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "subjNo": "9400501111111111",
  • "subjClss": "2",
  • "regAcciCode": "0111",
  • "recDate": "20240516",
  • "recTime": "151031",
  • "receNo": "1"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}

5. 기타

체크카드 시스템 구축을 위한 기타 업무

회원등록 불능 사유 조회

회원등록 요청에 대한 응답 불능 코드에 해당하는 사유명을 조회합니다.
회원등록 응답 필드에 사유명이 있어, 별도 필요시에만 협의합니다.

Request Body schema: application/json;charset=UTF-8
required
Array of objects (FailRsonReqVO)
Default: [{"rsonNo":"1091"},{"rsonNo":"1111"}]

불능사유리스트 결과 목록

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "incpRsonLst": [
    ]
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "code": "00",
  • "message": "정상처리",
  • "incpRsonLst": [
    ]
}

주소 검증 조회

개인카드 신규 발급 및 정보(주소) 제신고 시, 사전에 주소의 적합성 여부를 검증합니다.

Request Body schema: application/json;charset=UTF-8
required
zpNo1
required
string = 5 characters
Default: "04548"

[신주소] 5자리 우편번호

addr11
required
string <= 100 characters
Default: "서울 중구 을지로 170"

[신주소] 도로명주소

addr12
required
string <= 100 characters
Default: "비씨카드(을지로4가, 을지트윈타워)"

[신주소] 상세주소

Responses

Request samples

Content type
application/json;charset=UTF-8
{
  • "zpNo1": "04548",
  • "addr11": "서울 중구 을지로 170",
  • "addr12": "비씨카드(을지로4가, 을지트윈타워)"
}

Response samples

Content type
application/json;charset=UTF-8
{
  • "status": {
    },
  • "resData": {
    }
}