ADR-T-005

가맹점 구독 결제는 웹 기반 Stripe 결제로 시작하고, 모바일 인앱결제는 사용하지 않는다

ADR ID: ADR-T-005
상태: Accepted
작성일: 2026-03-02
작성자: YSY
관련 ADR: ADR-P-001, ADR-T-001, ADR-T-002

1. 배경 (Context)

플랫폼의 수익 구조는 가맹점 구독 모델이다.
사용자는 슬롯 사용 시 결제를 하지 않는다.
결제는 “가맹점 운영 도구 사용료”에 한정된다.

모바일 앱 내에서 구독 결제를 처리할 경우 다음 문제가 발생한다:

Google Play / Apple App Store 인앱결제(IAP) 정책 적용
수수료 15~30% 발생
플랫폼 정책 제약 증가
심사 리스크
앱스토어 가이드라인에 종속

가맹점은 일반 사용자와 다르며,
관리 기능은 웹 기반으로 제공하는 것이 자연스럽다.

2. 결정 (Decision)

가맹점 구독 결제는 웹 기반 Stripe 결제로 처리한다.

모바일 앱 내 인앱결제(IAP)는 도입하지 않는다.

구독 관리(플랜 변경/해지/결제 수단 변경)는
웹 가맹점 관리자 페이지에서만 제공한다.

3. 대안 (Alternatives Considered)

대안 A: 모바일 인앱결제(IAP) 도입

설명
Google Play / Apple IAP 사용

장점

플랫폼 정책 준수 용이
앱 내에서 결제 완료 가능

단점

수수료 15~30%
플랜 변경 로직 복잡
가맹점 전용 앱 별도 설계 필요
스토어 심사 리스크

채택하지 않은 이유
가맹점은 일반 소비자가 아니며,
운영 도구 결제에 앱스토어 수수료를 적용할 이유가 없다.

대안 B: 자체 결제 서버 + PG 직접 연동

설명
국내 PG사 직접 계약 및 서버 구현

장점

완전한 통제
장기 비용 절감 가능

단점

계약/정산/보안 부담
1인 개발 단계에서 과도한 복잡성

채택하지 않은 이유
초기 단계에서는 Stripe의 안정성과 단순성이 더 적합하다.

대안 C: Stripe + 모바일 결제 혼합

설명
웹과 모바일에서 모두 결제 지원

장점

유연성

단점

정책 충돌 가능성
구조 복잡성 증가

채택하지 않은 이유
MVP 단계에서 혼합 전략은 불필요한 복잡성을 만든다.

4. 결과 (Consequences)

긍정적 결과

앱스토어 수수료 회피
결제 로직 단순화
구독 관리 UI를 웹에 집중 가능
정책 리스크 감소

부정적 결과

가맹점은 웹에서 결제해야 함
모바일 앱에서 완결된 결제 경험 제공 불가
Stripe 의존성 존재

5. 영향 범위 (Impact)

기술

Stripe 구독 API 연동 필요
웹 관리자 페이지 필수
구독 상태를 Supabase와 동기화해야 함

모바일 앱은 “운영 도구”
결제는 웹에서 진행하도록 안내

운영

Stripe 계정 관리
세금/정산 체계 설계 필요

6. 재검토 조건 (Revisit Conditions)

다음 조건 중 하나 이상 충족 시 재검토:

가맹점이 모바일 결제를 강하게 요구
스토어 정책 변경으로 웹 결제 제한 발생
구독 매출이 일정 규모 이상 증가하여 자체 PG 전환이 유리해질 경우

Buy me a coffee

ADR-T-004 ADR-T-006