BullMQ 기반 비동기 큐와 Idempotency 구현을 통한 안정적 결제 Webhook 아키텍처 구축

Context

결제 시스템의 Webhook 처리 시 발생 가능한 중복 이벤트 처리 문제와 서버 부하로 인한 이벤트 유실 위험 존재. 단순 HTTP 요청 처리 방식으로는 분산 환경에서의 데이터 정합성 보장 및 장애 복구 능력이 부족한 한계점 분석.

Technical Solution

• Stripe Signature 검증을 통한 요청 출처 확인 및 보안 무결성 확보
• BullMQ 및 Redis 도입을 통한 비동기 이벤트 큐잉 구조 설계로 처리 성능 향상 및 서버 부하 분산
• Event ID 기반의 Idempotency 로직 구현을 통한 중복 결제 처리 방지 및 데이터 일관성 유지
• Exponential Backoff 전략을 적용한 재시도 메커니즘 구축으로 일시적 장애 상황의 복구력 강화
• 모든 수신 이벤트를 DB에 기록하는 Auditing 구조 설계를 통한 사후 추적 및 디버깅 환경 마련
• body-parser.raw 설정을 통한 원본 바디 유지로 Signature 검증 로직의 정확도 확보