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": "신용"
    }
}