구독 시나리오 가이드
문서 정보
- 작성일: 2026-03-07
- 버전: v1.0.0
- 관련 이슈: #753 (환불 정책 재설계)
TL;DR
available-actions API가 현재 상태에서 가능한 액션을 알려줍니다. 이 문서는 **"이런 상태에서 이렇게 하면 어떻게 되는지"**를 시나리오별로 설명합니다.
플랜 구성
| 플랜 | 가격 | 계층 |
|---|---|---|
| FREE | 무료 | 기본 |
| PLUS | 7,900원/월 | 중급 |
| PRO | 9,900원/월 | 최상위 |
계층: FREE < PLUS < PRO
상태별 가능한 액션
아래 표는 각 구독 상태에서 어떤 액션이 가능한지 보여줍니다.
| 액션 | ACTIVE | ACTIVE + 예약 변경 | PENDING_CANCEL |
|---|---|---|---|
| 즉시 플랜 변경 | O | X | X |
| 예약 플랜 변경 | O | X | X |
| 구독 해지 | O | O | X |
| 예약 변경 취소 | X | O | X |
| 해지 철회 | X | X | O |
| 구독 전체 환불 | 조건부 | 조건부 | 조건부 |
| 차액 환불 | 조건부 | 조건부 | 조 건부 |
즉시 업그레이드 결제 금액은 업그레이드 시점에 따라 달라질 수 있습니다. 결제 당일 업그레이드는 플랜 차액 전액, 다음 날부터는 남은 기간을 반영한 차액이 적용됩니다.
환불 조건
| 환불 유형 | 조건 |
|---|---|
| 구독 전체 환불 | 7일 이내 + 혜택 미사용 (업그레이드 상태면 이전 구독도 환불 가능해야 함) |
| 차액 환불 | 업그레이드 후 7일 이내 + 업그레이드 이력 존재 |
환불 조건을 충족하면 어떤 상태에서든 (ACTIVE, 예약 변경 중, PENDING_CANCEL) 환불 액션이 노출됩니다.
환불 가능 여부 판정
혜택 사용으로 환불 불가가 되는 시점
| 시점 | 설명 |
|---|---|
| 업그레이드 시 기존 스케줄에 적용 | applyToExistingSchedules 선택 |
| 멤버십 스케줄 생성 | 녹화 생성 시 자동 |
| 스케줄 예약 | 예약 시 자동 |
| 유료 스케줄 공유 수신 | 공유받은 시점에 자동 |
시나리오 목록
각 시나리오는 조건 → 플로우 → 상태 변화 → 결과로 구성됩니다.
| # | 시나리오 | 설명 |
|---|---|---|
| 1 | 신규 가입 | FREE → PLUS/PRO 첫 구독 |
| 2 | 즉시 업그레이드 | PLUS → PRO 즉시 플랜 변경 |
| 3 | 예약 변경 | 다음 결제일에 플랜 변경 (업/다운) |
| 4 | 구독 해지 & 해지 철회 | 취소 예정 → 만료 또는 철회 |
| 5 | 플랜 변경 차액 환불 | 업그레이드 차액만 환불 + 이전 플랜 복원 |
| 6 | 구독 전체 환불 | 전액 환불 + 즉시 해지 |
| 7 | 리워드 자동 적용 | 구독/업그레이드 시 리워드 차감 + 환불 시 복원 |
관련 문서
- 구독 시스템 — 구독의 동작 원리 (결제 갱신, 재시도, 리워드 차감)
- 멤버십 라이프사이클 — 구독/권한/리워드 카운터의 전체 생명주기