계좌 조회 API를 쓸 때 이용자가 확인할 수 있는 보안 항목
뱅크레일에서 이용자가 직접 확인할 수 있는 위임, 조회 전용, 보관 기간, 계정 관리 항목을 정리했습니다.
이용자가 직접 확인할 수 있는 보안 항목에는 무엇이 있나요?
보안은 제공사가 말하는 내용보다 이용자가 눈으로 확인할 수 있는 항목으로 판단하는 편이 낫습니다. 이 글은 내부 구현을 설명하지 않고, 뱅크레일 이용자가 문서와 콘솔에서 확인할 수 있는 범위만 다룹니다.
| 확인 항목 | 뱅크레일의 공개 기준 | 이용자가 확인하는 곳 |
|---|---|---|
| 권한 위임 | 회원사가 최종 사용자의 위임을 받아 조회하는 용도로만 씁니다 | 이용약관 |
| 할 수 있는 일의 범위 | 조회 전용입니다. 입금과 이체를 실행하는 기능이 없고 카드 사용내역 조회도 없습니다 | 연동 가이드 |
| 실시간 거래내역 | 요청한 시점에 은행에서 가져와 응답하며 저장하지 않습니다 | 연동 가이드 |
| 저장된 결과 | 계좌번호는 가려진 상태로 제공되고, 거래내역은 정해진 기간만 보관합니다 | 연동 가이드 |
| API 키 | 모든 요청의 X-API-Key 헤더로 인증하며, 콘솔에서 재발급할 수 있습니다 | 회원 콘솔 |
| 회원 상태 | 정지되거나 서비스 기간이 끝난 회원은 새 조회를 할 수 없고 지난 내역은 볼 수 있습니다 | 회원 콘솔 |
최종 사용자는 어떤 권리를 가지나요?
이용자는 본인 정보의 열람, 정정, 삭제, 처리 정지를 이메일로 요청할 수 있습니다. 접수 방법은 개인정보처리방침에서 확인하세요.
회원사는 자기 쪽에서 무엇을 지켜야 하나요?
API 키는 서버에서만 보관하고 클라이언트 코드에 넣지 않습니다. 유출이 의심되면 콘솔에서 재발급하세요.
최종 사용자의 위임을 받은 기록을 남기고, 위임 범위 밖의 조회는 하지 않습니다.
웹훅은 같은 작업의 알림이 중복될 수 있으므로 job_id로 구분해 한 번만 처리합니다.
조회 결과를 자체 저장소에 둔다면 접근 권한과 보관 기간을 정해 관리합니다.
이 글로 안전이 보장되나요?
아닙니다. 이 글은 이용자가 확인할 수 있는 공개 기준을 정리한 것이며 안전을 보장하지 않습니다. 뱅크레일은 금융기관의 공식 API가 아닌 방식으로 조회하므로 은행 시스템 변경 등으로 조회가 일시 중단될 수 있습니다. 약관과 방침을 직접 확인한 뒤 도입을 판단하세요. 이용 조건은 이용약관에 있습니다.