Sync API의 Async 전환을 통한 핀테크 계좌 개설 파이프라인 신뢰성 확보

Context

기존 Synchronous API 방식의 블로킹 구조로 인한 확장성 한계 및 외부 뱅킹 제공사의 API Deprecation 대응 필요성 발생. 요청-응답의 원자적 트랜잭션 구조를 포기하고 비동기 Webhook 기반의 분산 시스템으로의 전환이 요구된 상황.

Technical Solution

• Wait State 기반 State Machine 도입을 통해 요청 생성 후 Webhook 수신 전까지의 상태를 InProgress로 관리하는 앵커 구조 설계
• Webhook 유실 대응을 위해 30분 주기 Polling 및 최대 12시간의 Bounded Waiting 타임아웃 정책 적용으로 시스템 불확실성 제거
• ID와 Status를 조합한 Composite Key 기반 Cache Lock 레이어를 구축하여 At-least-once 전달로 인한 Burst Retry 및 중복 처리 방지
• 운영 환경과 동일한 파이프라인을 타는 Sandbox Endpoint를 구축하여 외부 의존성 없는 E2E 통합 테스트 환경 구현
• Market 단위의 Dynamic Feature Flag를 적용하여 점진적 롤아웃 및 장애 시 즉각적인 Legacy Sync Flow 롤백 경로 확보