금융결제원 API(1)

글 순서

• 사용 배경
• 이체동작 과정
• 회원가입 및 API 신청
• 사용자 인증 및 계좌 등록
• AcessToken 획득

사용 배경

프로젝트 중 이체기능텍스트을 구현하려다보니, 실제 금융사, 핀테크 기업에서는 어떻게 이체를 처리하는지 궁금해졌습니다.

• 은행 앱: 은행1 계좌->은행2 계좌로의 이체
• 핀테크 앱: 은행1 계좌->은행2 계좌로의 이체

그러던 중 금융결제원의 오픈뱅킹API를 통해 이체를 구현할 수 있는 것을 알게되고, 이를 구현하고자 하였습니다.

이체동작 과정

이체와 관련된 주요 API들입니다.
(수치 조회와 같은 추가 API들이 추가적으로 필요할 수 있습니다)

• 출금이체 API: 이용기관이 출금에 동의한 사용자 계좌에서 자금을 출금하여 이용기관의 수납계좌로 입금
  

• 입금이체 API: 이용기관이 지급계좌에서 자금을 인출하여 수취인 계좌로 입금
  

회원가입 및 API 신청

금융결제원 개발자사이트에 대한 회원가입을 진행합니다.

MyPage에서 오픈뱅킹 서비스를 신청합니다. 이용허가까지 시간이 조금 걸렸던 것 같습니다.

Callback URL을 저장하고, 오픈뱅킹 서비스에 등록해줍니다.

사용자 인증 및 계좌 등록

위의 이체 API를 사용하기전, 사용자 인증 및 계좌 등록을 먼저 해주어야 합니다. 요청 명세서는 금융결제원 자료실에서 제공해주고, 저는 관련 사이트도 참고하였습니다. [명세서 다운로드]

• 사용자 인증 API
  Postman에 요청문을 작성해주었습니다. 이 때, URL의 openapi는 testapi로 변경하여 요청을 보내야합니다.
  
  요청 후, 이런 결과가 나오면 잘 실행된 것입니다.
  
  쿼리 파라미터가 작성된 URL을 복사해서 인터넷창에 붙여넣으면 아래와 같은 창이 나옵니다. 여기서 휴대전화 본인인증을 진행하고, 계좌등록까지 해줍니다. (테스트라 그런지 계좌 등록시 실계좌를 넣지 않아도 괜찮은 듯 합니다)
  
  모든 과정이 끝나면 redirect URL로 이동되고, 넘어온 파라미터 값들도 확인할 수 있습니다.넘어온 파라미터 중 code는 accessToken획득에 필요하니 저장해 두어야합니다.
  

AcessToken 획득

이체 API를 사용하기전, accessToken을 먼저 획득해야합니다.

• 사용자 토큰 발급 API
  사용자 인증 당시 얻은 code값을 바탕으로 요청메시지를 작성합니다.
  

• 이용기관 토큰 발급 API