개발자가 Stripe 웹훅의 무음 실패 문제를 겪은 후 Hooklog를 구축해 웹훅 페이로드 검사, 실패 알림, 재전송 기능 제공

Context

Stripe 웹훅은 페이로드 처리 중 에러로 500을 반환하면 Stripe가 재시도한 후 자동으로 포기하지만, 개발자는 며칠 뒤 고객 문의로 문제를 발견하게 된다. ngrok, Webhook.site, RequestBin 같은 기존 도구들은 URL 캡처만 제공하고 서버의 오류 응답으로 인한 무음 실패를 감지하지 못한다.

Technical Solution

• 웹훅 프록시 설계: 모든 웹훅 요청을 중간에서 가로채고 라이브 페이로드 검사 제공
• 응답 코드 모니터링: 엔드포인트가 4xx 또는 5xx 반환 시 즉시 이메일 알림 발송
• 웹훅 재전송 기능: 디버깅을 위해 캡처된 웹훅을 다시 전송 가능
• Next.js, Express, PostgreSQL 스택으로 구현: Docker 컨테이너화해 주말 동안 프로덕션 배포
• 가입 없이 즉시 사용: 엔드포인트 생성 후 30초 내 웹훅 송수신 시작 가능

Key Takeaway

웹훅 디버깅 도구는 요청 캡처 기능보다 서버 응답 실패 감지와 즉각적인 알림이 더 중요한데, 기존 도구들이 이를 간과했다는 점에서 구체적인 통증점 해결이 제품 차별화의 핵심이다.