통합포털사이트
최근검색어
    오픈API
    계좌실명조회
    "계좌실명조회 API"는 이용기관이 특정 계좌의 계좌번호와 인증정보(실명번호 앞 6자리 등 혹은 사업자등록번호)를 보유하고 있는 경우, 해당 계좌의 예금주 성명을 확인합니다. 예를 들면 고객에게 결제대금을 환불하기 위한 환불계좌의 유효성을 확인하기 위한 용도로 사용될 수 있습니다. 계좌실명조회 API의 경우 핀테크이용번호가 아닌 고객의 실계좌번호를 사용하여 API를 호출합니다. 또한 Access Token은 이용기관과 오픈뱅킹 간의 2-legged 인증을 통하여 획득한 Access Token을 사용합니다.
    계좌실명조회
    계좌실명조회 API는 POST 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.
    요청메시지 URL
    요청메시지 URL
    HTTP URL https://openapi.openbanking.or.kr/v2.0/inquiry/real_name
    HTTP Method POST
    Content-Type application/json; charset=UTF-8
    요청 메시지 명세
    요청 메시지 명세
    HTTP 항목 값 TYPE(길이) 설명
    Header Authorization Bearer <access_token> 조회서비스 계좌등록 시
    오픈뱅킹으로부터 전송받은
    access _token을
    HTTP Header에 추가
    [scope = oob]
    Parameter bank_tran_id "F123456789U4BC34239Z" AN(20) 은행거래고유번호
    bank_code_std "098" AN(3) 개설기관.표준코드
    account_num "0001230000678" AN(16) 계좌번호
    accoun_seq “001” AN(3) 회차번호
    account_holder_info_type “1” AN(1) 예금주 실명번호 구분코드
    account_holder_info "8801012" AN(13) 예금주 인증정보
    tran_dtime "20160310101921" N(14) 요청일시
    요청 메시지 형태
    {
    "bank_code_std": "bank_tran_id": "F123456789U4BC34239Z",
    "bank_code_std": "097",
    "account_num": "1101230000678",
    "account_holder_info_type": " ",
    "account_holder_info": "880101",
    "tran_dtime": "20190910101921"
}
    응답 메시지 명세
    응답 메시지 명세
    HTTP 항목 값 TYPE(길이) 설명
    Body api_tran_id "AA12349BHZ1324K82AL3" aNS(40) 거래고유번호(API)
    api_tran_dtm "20160310101921567" N(17) 거래일시
    (밀리세컨드)
    rsp_code "A0000" AN(5) 응답코드(API)
    rsp_message "" AH(300) 응답메시지(API)
    bank_tran_id "12345678901234567890" AN(20) 거래고유번호
    (참가기관)
    bank_tran_date "20160310" N(8) 거래일자
    (참가기관)
    bank_code_tran "098" AN(3) 응답코드를 부여한
    참가기관 표준코드
    bank_rsp_code "000" AN(3) 응답코드
    (참가기관)
    bank_rsp_message "" AN(100) 응답메시지
    (참가기관)
    bank_code_std "098" AN(3) 개설기관.표준코드
    bank_code_sub "1230001" AN(7) 개설기관.점별코드
    bank_name "오픈은행" AH(20) 개설기관명
    savings_bank_name “오픈저축은행” AH(20) 개별저축은행명
    account_num "0001230000678" AN(16) 계좌번호
    account_seq “001” AN(3) 회차번호
    account_holder_info_type [" "|"1"|"2"|"3"|"4"|"5"|"6"|"E"|"N"] AN(1) 예금주 실명번호 구분코드
    account_holder_info "8801012" N(12) 거래금액
    account_holder_name "홍길동" AH(20) 예금주 성명
    account_type “1” AN(1) 계좌종류
    1:수시입출금,
    2:예적금,
    6:수익증권
    응답 메시지 형태
    {
    "api_tran_id": "2ffd133a-d17a-431d-a6a5",
    "api_tran_dtm": "20190910101921567",
    "rsp_code": "A0000",
    "rsp_message": "",
    "bank_tran_id": "F123456789U4BC34239Z",
    "bank_tran_date": "20190910",
    "bank_code_tran": "097",
    "bank_rsp_code": "000",
    "bank_rsp_message": "",
    "bank_code_std": "097",
    "bank_code_sub": "1230001",
    "bank_name": "오픈은행",
    "account_num": "1101230000678",
    "account_holder_info_type": " ",
    "account_holder_info": "880101",
    "account_holder_name": "홍길동",
    "account_type": "1"
}
    패밀리사이트
    본관 : 06220 서울특별시 강남구 테헤란로 202(역삼동)
    분당센터 : 13556 경기도 성남시 분당구 정자일로213번길 9(정자동)
    Copyright ⓒ 2019 KFTC (Korea Financial Telecommunications & Clearings Institute) All rights reserved.
    loading_icon