멀티테넌트 SaaS가 Stripe Connect로 결제 연동 시 OAuth-Webhook 통합 패턴을 통해 플랫폼 수수료 자동 정산 구조를 구축한다

Context

멀티테넌트 SaaS는 각 고객이 자체 Stripe 계정을 보유하며 해당 고객의 최종 사용자가 결제하는 구조를 처리해야 한다. 플랫폼은 각 거래에서 수수료를 차감하고 모든 연결 계정의 웹훅을 처리하며 데이터 격리를 보장해야 한다. Stripe 문서는 200페이지 이상이며 기존 튜토리얼은 핵심 구현 세부사항을 생략한다.

Technical Solution

• 고객 → Standard 계정 OAuth 통해 stripe_user_id 연동 및 영구 저장
• PaymentIntent → application_fee_amount 설정으로 플랫폼 수수료 자동 차감
• 웹훅 엔드포인트 → event.account 필드로 연결 계정 식별 후 분기 처리
• 웹훅 핸들러 → event.id 기반 멱등성 체크로 중복 처리 방지
• 데이터 격리 → 데이터베이스 RLS 적용으로テ넌트별 데이터 분리

Impact

수수료 정산 자동화로 수동 분배 작업 불필요

Key Takeaway

Stripe Connect 개별 컴포넌트는 단순하지만 모든 요소(OAuth, PaymentIntent, Webhook, Idempotency, RLS)를 동시에 정확히 구현하는 것이 핵심이다.