DEV ZZAME logoDEV ZZAME
Back To Projects

Project Archive

홈택스 로그인 인증 모듈 연동

빠른정산 서비스 신청 시 사업자의 재정 건전성을 검토하기 위해 홈택스에서 발급되는 세무 증명서를 자동으로 수집할 필요가 있었음.

JavaSpring BootMariaDBAWSDocker

Why

  • 빠른정산 서비스 신청 시 사업자의 재정 건전성을 검토하기 위해 홈택스에서 발급되는 세무 증명서를 자동으로 수집할 필요가 있었음.
  • 수동 발급 방식은 처리 속도가 느리고 운영 비용이 높아 자동화가 필수적이었음.

Challenge

  • 사업자 유형별 상이한 인증 방식: 법인 사업자는 공동인증서(Ex-adapter 모듈 연동), 개인 사업자는 카카오·네이버 등 간편인증(Hyphen API 연동) 방식으로 각각 다른 인증 플로우를 처리해야 했음.
  • 중복 발급 방지: 동일 사업자에 대해 하루에 여러 번 발급 요청이 발생할 수 있어 불필요한 중복 발급을 막는 로직이 필요했음.
  • 다종 증명서 파싱: 사업자등록증명원, 납세완납증명서, 부가가치세 과세표준증명원, 표준재무제표증명원, 소득금액증명원 등 6종의 증명서를 각각 다른 파싱 로직으로 처리해야 했음.

To Be

  • 인증 방식 통합 관리: 법인 사업자는 Ex-adapter 모듈을 연동하여 공동인증서 로그인을 처리하고, 개인 사업자는 Hyphen API의 간편인증 플로우를 구현하여 사업자 유형에 따라 자동으로 적합한 인증 방식이 선택되도록 설계함.
  • 6종 증명서 자동 발급 및 파싱: 각 증명서에 맞는 API를 호출하여 데이터를 수집하고 S3에 저장함. 당일 발급 이력 확인 로직을 추가하여 중복 발급을 차단하고, 발급 결과를 Slack으로 알림 전송하여 운영팀이 실시간으로 확인할 수 있도록 함.