금융 데이터 API 도입 전 확인할 점

은행 계좌 조회 API를 도입하기 전에 제공사에 확인할 질문을 이용 대상, 동의, 조회 방식, 장애 대응 기준으로 정리했습니다.

금융 데이터 API를 고를 때 무엇부터 물어봐야 하나요?

도입을 검토할 때 기능표만 비교하면 놓치는 것이 있습니다. 순서를 바꿔 보면, 기능 목록보다 먼저 조회 방식, 이용 대상, 동의 절차, 장애 시 동작을 확인해야 합니다. 같은 계좌 조회 API라도 방식에 따라 쓸 수 있는 범위와 위험이 달라지기 때문입니다.

이 글은 제공사에 던질 질문을 정리한 일반 체크리스트입니다. 특정 서비스의 내부 구현을 설명하지 않으며, 각 질문의 답은 제공사의 공식 문서와 약관으로 확인해야 합니다.

어떤 항목을 확인하나요?

확인 항목질문
이용 대상개인도 쓸 수 있는지, 사업자만 쓸 수 있는지. 최종 사용자와 계약 주체가 누구인지
동의와 위임최종 사용자의 동의를 누가 어떤 방식으로 받는지. 동의 철회와 정보 열람·정정·삭제 요청은 어디로 접수하는지
조회 방식금융기관의 공식 API를 쓰는지, 다른 방식으로 조회하는지. 방식에 따라 일시 중단 가능성이 있는지
응답 방식요청 즉시 응답하는지, 접수 후 비동기로 처리하는지. 완료는 어떻게 알려 주는지
알림알림이 조회 작업의 완료를 알리는 것인지, 거래나 잔액 변화를 알리는 것인지. 중복 전송이 있는지
인증키 관리API 키를 재발급할 수 있는지. 키 노출 시 대응 절차가 있는지
지원 범위지원 은행과 계정 종류(개인·법인)는 어디까지인지. 지원하지 않는 기능은 무엇인지
장애 대응조회 실패나 일시 중단 시 어떤 응답을 주는지. 재시도 기준은 무엇인지
요금요금 기준과 최신 안내가 공개된 한 곳이 있는지

제공사가 답하지 못하면 어떻게 하나요?

  • 문서에 근거가 없는 답변은 도입 판단에 쓰지 않습니다. 약관과 법적 고지 같은 공개 문서에서 확인할 수 있는 내용만 기준으로 삼으세요.

  • 보안 수준이나 규정 준수를 강조하는 문구는 어떤 근거에서 나왔는지 확인하세요. 근거가 없으면 판단 자료에서 뺍니다.

  • 도입 후 서비스에 안내할 한계(일시 중단 가능성, 조회 소요 시간 등)를 미리 정리해 두세요.

제공사가 한계를 어디에 공개하는지 보려면 법적 고지 같은 문서를 확인하세요. 뱅크레일의 경우 법적 고지에 조회 방식의 한계가 적혀 있습니다.

제공사에 보내는 질문은 어떻게 정리하나요?

아래처럼 항목별로 질문을 만들어 두면 제공사마다 답을 같은 틀로 비교할 수 있습니다. 오른쪽 열은 뱅크레일이 공개한 기준입니다.

확인 항목제공사에 묻는 말뱅크레일의 공개 기준
조회 방식금융기관 공식 API인가요?아닙니다. 공동인증서로 은행 인터넷뱅킹에 접속해 조회합니다
이용 대상개인도 쓸 수 있나요?B2B 전용이며 회원은 사업자입니다
동의최종 사용자 동의는 누가 받나요?회원사가 위임과 동의를 받아야 합니다
기능 범위이체나 카드 조회도 되나요?조회 전용이며 이체와 카드 사용내역 조회는 없습니다
장애은행 시스템이 바뀌면 어떻게 되나요?조회가 일시 중단될 수 있습니다

자주 묻는 질문

보안 항목은 어디까지 물어봐야 하나요?

내부 구현을 공개하라고 요구하기보다, 인증키 재발급, 접근 이력 확인, 정지 회원 처리처럼 운영에서 확인 가능한 항목을 물어보세요.

체크리스트를 통과하면 안전하다고 볼 수 있나요?

아닙니다. 이 체크리스트는 도입 판단에 필요한 질문을 빠뜨리지 않기 위한 것이며 안전을 보장하지 않습니다.

목록으로