자주 묻는 질문

Bank API는 국내 은행 계좌 조회 기능을 REST API로 제공하는 서비스입니다. 개발자들이 쉽게 은행 데이터를 연동할 수 있도록 도와드립니다. 거래내역 조회, 잔액 확인 등의 기능을 간단한 API 호출로 이용할 수 있습니다.

현재 농협, 국민, 우리, 기업, 신한은행을 지원합니다. 각 은행의 빠른계좌(간편조회)가 등록되어 있어야 조회가 가능합니다. 지원 은행은 지속적으로 확대하고 있습니다.

네, 완전 무료로 사용하실 수 있습니다. Bank API는 스타트업·소상공인·개발자를 위한 무료 오픈 서비스로, 테스트, 학습, 개인 프로젝트 등 다양한 용도로 활용 가능합니다.

이메일 인증 후 즉시 API Key와 Secret Key가 발급됩니다. 회원가입 후 이메일로 전송되며, 보안을 위해 한 번만 확인 가능합니다. 발급받은 키는 안전한 곳에 보관해주세요.

보안상 기존 키는 복구가 불가능합니다. 새로운 API Key를 발급받으시거나, 문의 페이지를 통해 연락해 주시면 본인 확인 후 도움드리겠습니다.

네, 프로젝트별로 여러 개의 Secret Key를 생성하여 관리할 수 있습니다. 자세한 내용은 요금제 페이지에서 확인해주세요.

즉시 해당 키를 비활성화하고 새로운 키를 발급받으세요. API Key가 노출되면 누군가 악용할 수 있으므로, 빠른 조치가 필요합니다. 문의하기를 통해 도움을 받으실 수 있습니다.

Bank API는 완전 무료이며 월간 건수 상한이 없습니다. 다만 같은 계좌는 5분에 1회만 조회할 수 있고, 30분당 최대 30회(성공)·60회(요청)의 제한이 적용됩니다. 테스트 및 개인 프로젝트에 적합합니다.

Bank API는 완전 무료이며 앞으로도 유료화 계획이 없습니다. 별도의 요금제 변경이나 결제 없이 모든 기능을 이용하실 수 있습니다. 궁금한 점은 문의하기를 통해 알려주세요.

Bank API는 완전 무료라 어떠한 결제도 발생하지 않습니다. 카드나 계좌 등록 없이 바로 사용하실 수 있습니다. 자세한 내용은 문의해 주세요.

Bank API는 완전 무료이므로 결제나 할인 개념이 없습니다. 자세한 내용은 요금제 페이지에서 확인하실 수 있습니다.

은행 서버 특성상 응답 시간이 보통 1~3초 정도 소요됩니다. 은행 서버 상태나 네트워크 환경에 따라 응답 시간이 달라질 수 있습니다.

429 Too Many Requests 에러가 반환됩니다. 응답 헤더의 Retry-After(또는 응답 본문의 retryAfterSec)에서 재시도까지 남은 시간(초)을 확인할 수 있습니다. 같은 계좌는 5분에 1회, 30분당 최대 30회(성공)·60회(요청)까지 조회할 수 있으니 잠시 후 다시 시도해 주세요.

현재 REST API만 제공하며, JavaScript, Python, Java, Go 등 다양한 언어의 예제 코드를 계좌조회 API 문서에서 확인하실 수 있습니다. SDK는 추후 제공 예정입니다.

지원하지 않습니다. 그리고 이건 못 하는 게 아니라 하지 않는 것입니다. Webhook으로 입금을 실시간 감지하려면 서버가 고객의 계좌번호·비밀번호를 저장해두고 주기적으로 대신 조회해야 하는데, 이는 저희의 무저장 원칙과 정면으로 충돌합니다. 설령 암호화해서 DB에 저장하더라도 결국 조회를 위해 복호화가 가능해야 하므로, "저장하지만 안전하다"는 말은 성립하지 않습니다. 저희는 고객의 계좌 정보를 어떤 형태로도(암호화·해시 포함) 저장하지 않기 때문에, 조회는 고객이 직접 요청하는 순간에만 이뤄집니다. 실시간 감지가 필요하시면 cron·스케줄러로 조회 API를 주기적으로 호출하는 방식(자동 입금확인 가이드)을 권장합니다.

모든 통신은 HTTPS(TLS 1.3)로 암호화되며, 계좌 정보는 서버에 저장되지 않습니다. API Key와 Secret Key도 SHA256 해시 처리되어 저장됩니다.

네, Secret Key별로 IP 화이트리스트를 설정할 수 있습니다. 이 기능을 활용하면 승인된 서버에서만 API를 호출할 수 있어 보안이 강화됩니다.

개인정보 처리 방침은 문의 페이지를 통해 요청하시면 제공해 드립니다. Bank API는 사용자의 개인정보를 안전하게 보호합니다.