서비스 소개

이용 안내

이용절차

  1. STEP 1
    회원가입

    회원가입

    1. ① 기업은행 오픈API 포털을 이용하기 위해서는 회원가입을 해야합니다.
    2. ② 홈 화면의 “회원가입"버튼을 눌러 회원가입을 진행해 주세요.
    • 1인당 최대 2개의 계정까지 가입할 수 있습니다.
    • 개인회원 기업회원 계정 전환을 할 수 있습니다.
    • 회원가입 후 IBK관리자의 승인을 받아야 포털 이용이 가능합니다.
    • 개인회원
      IBK기업은행 API를 체험해보고 싶은 개인
      (앱을 생성하고 테스트베드를 통해 API 테스트만 가능합니다.)
    • 기업회원
      IBK기업은행 API를 통한 금융서비스를 만들고자 하는 기업
      (보안심사 후 제휴사로 등록되면 API를 실서비스에 적용할 수 있습니다.)
  2. STEP 2
    앱 및 API 이용신청

    앱 및 API 이용신청

    1. ① 로그인 후 [MY > 나의 앱 관리] 메뉴에서 앱을 생성하고 이용할 API를 선택해주세요.
    2. ② 앱을 생성하고 IBK관리자의 앱승인이 이루어지면 테스트용 Client ID와 Client Secret이 발급 됩니다.
    • 앱을 생성한 이후에도 API를 추가할 수 있습니다.
    • 앱 생성 또는 새로운 API 추가 시, IBK관리자의 API 이용승인이 필요합니다.
  3. STEP 3
    개발테스트

    개발테스트

    1. ① 포털 내 개발가이드를 참고하여 API 테스트를 진행합니다.
    2. ② 테스트베드는 Swagger UI를 제공합니다.
    • 개인회원인 경우 포털 내 테스트베드를 활용하여 개발테스트를 진행합니다.
    • 기업회원인 경우 포털 내 테스트베드 활용 및 필요시 별도 개발가이드를 제공해 드립니다.
  4. STEP 4
    운영전환 신청

    운영전환 신청 (기업회원만 가능)

    1. ① 테스트한 앱을 실서비스에 적용하기위해 정보보호 보안심사를 신청해주세요.
    2. ② 정보보호 보안심사 완료 후 IBK관리자가 별도로 연락드려 API 이용계약을 체결합니다.
    • 정보보호 보안심사는 기업회원만 신청할 수 있습니다.
    • 정보보호 보안심사 완료 후 개발자 포털(운영 사이트) 가입이 필요합니다.
  5. STEP 5
    운영 적용

    운영 적용 (기업회원만 가능)

    1. ① 개발자 포털(운영 사이트)에서 실서비스에 사용할 앱을 만들면 운영 키를 발급해 드립니다.
    2. ② 발급된 운영 키로 실서비스와 연결하면 제휴사 서비스에서 기업은행 API를 사용할 수 있습니다.

용어

용어 정리 표
오픈API 포털(테스트) 회원이 직접 응용프로그램과 서비스를 개발할 수 있도록 IBK의 오픈API를 제공하는 사이트입니다.
IBK의 승인을 받으면 포털 내 테스트베드에서 공개된 API를 테스트해볼 수 있습니다.
오픈API 포털(운영) 이용기관이 테스트 포털에서 개발한 서비스를 실제 서비스로 전환할 수 있도록 제공하는 사이트입니다.
실제 금융데이터 기반 API로 IBK의 승인을 득하고 별도의 API이용계약 체결이 필요합니다.
개인회원 오픈API 포털(테스트)을 체험해보고자 하는 일반개인, 대학생 등의 개인 이용자를 의미합니다.
기업회원(마스터) 오픈API 포털에 가입하여 자사의 비즈니스와 연계하고자 API를 통해 서비스를 개발/운영할 수 있는 기업 이용자입니다.
기업회원의 마스터는 오픈API 포털 내 전체(앱/API 신청/수정/삭제, 팀 관리 등) 이용권한을 가집니다.
기업회원(팀원) 마스터 관리하에 있는 앱 개발 구성원으로 오픈API 포털의 일부(앱/API 조회, 테스트베드 이용 등) 이용권한을 가집니다.
이용기관 IBK가 제공하는 오픈API를 이용하여 별도의 서비스 또는 프로그램을 개발 및 테스트하거나 제공하고자 하는 기관(핀테크 기업 등)을 의미합니다.
사용자 오픈API를 이용한 이용기관의 서비스 또는 프로그램을 사용하는 고객을 의미합니다.
API를 이용하려면 오픈API 포털에서 앱을 생성해야 합니다. 생성한 앱에는 오픈API 포털에서 필요한 API를 이용신청 할 수 있으며,
이용기관은 이 앱을 이용하여 자사 서비스에 활용할 수 있습니다.
각 앱은 오픈API 요청 허가를 판단하는데 필요한 정보인 키(Client ID, Client Secret)를 갖습니다.
API IBK가 회원에게 직접 응용프로그램과 서비스를 개발할 수 있도록 공개한 API(Application Programming Interface)를 의미합니다.
정보보호 보안심사 오픈API 포털(테스트)에서 개발한 앱을 이용기관 서비스에 정식으로 이용하기 위해서 API이용계약 체결 전 이용기관의 보안 적정성을
사전에 검토하는 절차입니다.
정보보호 보안심사는 기업회원(마스터)만 신청할 수 있으며, 개인은 신청할 수 없습니다.
자체인증 자체인증은 사용자의 개입 없이 단순히 이용기관이 자신에 대한 인증정보(Client ID, Client Secret)를 가지고 인증함으로써,
IBK으로부터 이용기관에 대한 Access Token을 획득하는 것을 의미합니다.
IBK인증 IBK인증은 사용자가 이용기관의 자사 서비스를 통하여 IBK API서비스에 접근하기 위한 인증 기능을 제공합니다.
사용자는 IBK의 인증 페이지에서 본인인증 및 조회/출금동의를 통하여 인증하고, 이용기관은 사용자의 Access Token을 얻음으로써
사용자 인증을 획득합니다.