BcMs

반응형

API 소개

은행권 공동 오픈플랫폼에서 이용기관은 5개의 서비스 API, 인증/관리 API를 이용할 수 있습니다.

서비스 API: 잔액조회 API, 거래내역조회 API, 계좌실명조회 API, 입금이체 API, 출금이체 API, 인증/관리 API: 사용자인증 API, 관리 API

서비스 API

잔액조회 API

사용자가 이용기관이 제공하는 서비스를 통해 본인계좌에 대한 잔액 및 출금가능금액을 조회하는 기능을 제공합니다.

사용자 (1. 조회요청)→ 이용기관 (2. 조회요청)→ {오픈플랫폼센터 (3. 사용자 인증)→ 사용자 & 오픈플랫폼센터 (3. 조회요청)→ 은행(사용자계좌)} (4. 조회응답)→  오픈플랫폼센터 (5. 조회응답)→ 이용기관 (6. 조회결과)→  사용자

거래내역조회 API

사용자가 이용기관이 제공하는 서비스를 통해 본인계좌에 대한 잔액 및 거래내역을 조회하는 기능을 제공합니다.

사용자 (1. 조회요청)→ 이용기관 (2. 조회요청)→ {오픈플랫폼센터 (3. 사용자 인증)→ 사용자 & 오픈플랫폼센터 (3. 조회요청)→ 은행(사용자계좌)} (4. 조회응답)→  오픈플랫폼센터 (5. 조회응답)→ 이용기관 (6. 조회결과)→  사용자

계좌실명조회 API

이용기관이 자금을 수취할 수취인 또는 출금이체 신청을 한 사용자 계좌의 정상여부 및 실명을 실시간 조회하는 기능을 제공합니다.

이용기관 (1. 계좌실명조회 요청)→ 오픈플랫폼센터 (2. 계좌조회 요청)→ 은행(조회대상 계좌) (3. 계좌조회 응답)→ 오픈플랫폼센터 (4. 계좌실명조회 결과)→ 이용기관

입금이체 API

이용기관의 지급계좌에서 자금을 인출하여 수취인 계좌로 실시간 입금하는 기능을 제공합니다.

이용기관 (1. 입급이체요청)→  오픈플랫폼센터 (2. 출금요청)→  출금은행(이용기관 지급계좌)  (3. 출금응답)→  오픈플랫폼센터 (4. 입금요청)→  입금은행(수취인 계좌) (5. 입금응답)→  오픈플랫폼센터 (6. 입금이체결과)→  이용기관

출금이체 API

이용기관의 출금에 동의한 사용자 계좌에서 출금하여 이용기관의 수납계좌로 실시간 입금하는 기능을 제공합니다.

이용기관 (1. 출금이체요청)→  오픈플랫폼센터 (2. 출금요청)→  출금은행(사용자 계좌)  (3. 출금응답)→  오픈플랫폼센터 (4. 입금요청)→  입금은행(이용기관 수납계좌) (5. 입금응답)→  오픈플랫폼센터 (6. 출금이체결과)→  이용기관

인증/관리 API

사용자인증 API

사용자인증 API는 5개의 서비스 API를 사용하기 위하여, 일반고객(사용자)의 인증 및 동의를 얻고 계좌등록을 수행하는 기능을 제공합니다. 이용기관은 계좌에 접근하기 위하여 먼저 이용기관의 응용프로그램(앱)과 사용자의 오픈플랫폼 아이디를 연결해야 하며, 이때 사용자인증 API를 호출하여 사용자의 인증 여부를 물을 수 있습니다. 일반고객은 오픈플랫폼에서 제공하는 연동 페이지에서 오픈플랫폼의 아이디/비밀번호로 인증하여 이용기관의 응용프로그램에게 아이디
연동을 허용합니다.
이러한 인증 절차는 대부분의 인터넷 서비스(페이스북, 트위터 등)에서 실질적인 표준으로 적용하고 있는 OAuth* 인증절차를 준용하여 구현되었습니다.

  • OAuth(Open Authentication) :

    오픈 API를 이용할 때 사용되는 표준화된 토큰 기반의 인증 방법

사용자인증-사용자 로그인 연결

사용자인증-계좌등록

관리 API

오픈플랫폼은 금융 업무를 처리하기 위한 5개의 서비스 API 이외에도 이용기관의 서비스 관리를 도와주는 관리 API를 제공합니다. 관리 API는 오픈플랫폼 운영 과정에서 이용기관의 요구를 반영하여 추가될 수 있으며, 현재는 참가은행의 서비스 상태를 조회하는 참가은행상태조회 API를 제공합니다.
이용기관은 참가은행상태조회 API를 호출하여 16개 참가은행의 서비스 상태를 한번에 조회할 수 있습니다. 참가은행의 서비스 상태는 “거래가능”(Y),
“장애”(D), “개시이전”(L), “종료처리”(E)로 정의됩니다.

참가기관상태조회

  • 관리 API는 오픈플랫폼을 이용하는 이용기관들이 만들어가는 API 입니다.

    직접적으로 금융 업무를 수행하는 서비스 API는 아니지만, 이용기관의 지속적인 서비스 관리를 도와주는 지원 성격의 API 입니다.
    비즈니스를 수행하면서 관리상 필요하다고 생각되는 API에 대한 아이디어는 “고객제안” 메뉴를 통하여 언제든 개진하실 수 있습니다

 

반응형

이 글을 공유합시다

facebook twitter googleplus kakaostory naver