Card

신용(체크)카드 관련 서비스를 제공합니다.

금융결제원 카드사 코드/명 조회 서비스
금융결제원 카드사표준코드와 카드사명 리스트를 리턴합니다.
End Point Method Parameter
/v1/card/inquiry/standard-info GET Json

Response
필드 설명 타입
card_code 카드사코드 String
card_name 카드사명 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 21,
    "list": [
      {
        "card_code": "361",
        "card_name": "BC카드"
      },
      {
        "card_code": "364",
        "card_name": "광주카드"
      },
      {
        "card_code": "365",
        "card_name": "삼성카드"
      },
      {
        "card_code": "366",
        "card_name": "신한카드"
      },
      #...
    ]
  }
}
카드사 무이자할부 조회 서비스
카드사에서 제공하는 무이자할부 정보를 리턴합니다.
End Point Method Parameter
/v1/card/inquiry/free-interest GET Json

Response
필드 설명 타입
card_code 카드사코드 String
card_name 카드사명 String
min_amount 무이자할부 적용 최소금액 String
free_installments 무이자할부 개월수 리스트 String
expired_at 무이자할부 적용 종료일시 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "total_count": 8,
    "list" : [
        {
          "card_code": "381",
          "min_amount": 50000,
          "expire": "2023-06-30 23:59:59",
          "card_name": "국민카드",
          "free_installments": "02:03"
        },
        {
          "card_code": "361",
          "min_amount": 50000,
          "expire": "2023-12-31 23:59:59",
          "card_name": "BC카드",
          "free_installments": "02:03:04:05:06"
        },
        {
          "card_code": "374",
          "min_amount": 50000,
          "expire": "2023-12-31 23:59:59",
          "card_name": "하나카드",
          "free_installments": "02:03"
        },
        #...
    ]
  }
}
카드 유효성 검사 서비스
신용/체크카드의 유효성을 검사 후 정상일 경우 카드사 정보를 리턴합니다.
End Point Method Parameter
/v1/card/inquiry/validation POST Json

Request Parameters
필드 설명 타입
card_number 카드번호 String
identification_number 식별번호(생년월일6자리 또는 사업자번호) String
expired_at 유효기간(YYYYMM) String
password_2digit 비밀번호 앞 2자리 String

Response
필드 설명 타입
card_name 카드사명 String

Response Sample

{
  "code": "0000",
  "message": "정상처리",
  "body": {
    "card_name": "BC카드"
  }
}
카드BIN 조회 서비스
카드BIN에 대한 카드정보를 리턴합니다.
End Point Method Parameter
/v1/card/inquiry/bin GET Query

Request Parameters
필드 설명 타입
bin_number 카드BIN번호 String

Response
필드 설명 타입
bin_number 카드BIN번호 String
owner_type 개인/법인구분 String
card_type 신용/체크구분 String
brand_name 브랜드사명 String
issuer 발급사 String
acquirer 매입사 String

Response Sample

{

    "code": "0000",
    "message": "정상처리",
    "body": {
        "bin_umber": "513792",
        "issuer": "롯데카드",
        "acquirer": "롯데카드",
        "owner_type": "개인",
        "brand_name": "Master",
        "card_type": "신용"
    }
}
카드 브랜드 판별 및 카드번호 검증 서비스
카드번호 앞자리로 국제 브랜드를 판별하고, 룬(Luhn) 체크섬과 브랜드별 자릿수로 카드번호 형식을 검증합니다.

카드사 조회 없이 서버 내부에서 계산하며, 카드의 실제 존재·사용 가능 여부는 확인하지 않습니다.(실제 카드 확인은 카드 유효성 검사 서비스를 이용해 주세요)
BIN(6~8자리)만 보내면 브랜드만 판별하고 luhn_valid, length_valid, is_valid, masked_card_number는 null로 리턴합니다.
is_valid가 false여도 검사가 정상 수행되었다면 code는 0000입니다.

End Point Method Parameter
/v1/card/inquiry/brand-number-check POST Body

Request Parameters
필드 설명 타입
card_number 카드번호 전체(12~19자리) 또는 BIN(6~8자리). 하이픈(-), 공백 허용 String

Response
필드 설명 타입
check_type CARD_NUMBER: 카드번호 전체 검사, BIN: BIN으로 브랜드만 판별 String
bin_number 카드번호 전체인 경우 앞 6자리, BIN인 경우 요청한 BIN String
masked_card_number 앞 6자리와 뒤 4자리를 제외하고 마스킹한 카드번호 (BIN인 경우 null) String
brand_code VISA, MASTERCARD, AMEX, JCB, DINERS, DISCOVER, UNIONPAY, UNKNOWN String
brand_name 브랜드명 (판별 불가 시 기타) String
luhn_valid 룬(Luhn) 체크섬 통과 여부 (BIN인 경우 null) Boolean
length_valid 브랜드별 자릿수 규칙 충족 여부, 판별 불가 브랜드는 12~19자리 여부 (BIN인 경우 null) Boolean
is_valid luhn_valid와 length_valid가 모두 true인 경우 true (BIN인 경우 null) Boolean

국내 전용카드(BC 로컬카드 등)는 국제 브랜드 범위에 없어 UNKNOWN(기타)으로 리턴됩니다.

Error Code
code HTTP Status 설명
0400 400 card_number 누락, 숫자 외 문자 포함, BIN 6~8자리 또는 카드번호 12~19자리가 아닌 경우
0502 200 요청을 처리하지 못하였습니다.(문의요망)

Request Sample

{ "card_number": "4111-1111-1111-1111" }
Response Sample (카드번호 전체)

{
    "code": "0000",
    "message": "정상처리",
    "body": {
        "check_type": "CARD_NUMBER",
        "bin_number": "411111",
        "masked_card_number": "411111******1111",
        "brand_code": "VISA",
        "brand_name": "Visa",
        "luhn_valid": true,
        "length_valid": true,
        "is_valid": true
    }
}
Response Sample (BIN)

{
    "code": "0000",
    "message": "정상처리",
    "body": {
        "check_type": "BIN",
        "bin_number": "513792",
        "masked_card_number": null,
        "brand_code": "MASTERCARD",
        "brand_name": "Mastercard",
        "luhn_valid": null,
        "length_valid": null,
        "is_valid": null
    }
}