요금 및 구독
Settings → Billing을 열면 현재 플랜, 결제 상태, 등록된 카드를 한눈에 확인할 수 있습니다.
이 가이드에서는 Billing 페이지에서 할 수 있는 모든 작업을 설명합니다. 플랜 확인, 결제 카드 업데이트, 청구서 관리, 취소된 구독 재개, 요금 알림 이해 등이 포함됩니다.
위치
Settings → Billing이 페이지에 액세스하려면 Admin (Billing) 권한이 필요합니다. 사이드바에 Billing이 표시되지 않으면 관리자에게 역할을 업데이트해 달라고 요청하세요.
빠른 참고
| 섹션 | 표시 내용 | 할 수 있는 작업 |
|---|---|---|
| Current Plan | 플랜 이름, 가격 내역, 플랜 코드, 체험 상태 | 구독 세부 정보 확인 |
| Status | 다음 청구일, 최근 결제, 연체/유예 기간 정보 | 결제 일정 확인 |
| Payment Method | 카드 브랜드, 끝 4자리, 만료일 | Stripe에서 카드 열어 업데이트 |
| Manage Subscription | Stripe Billing Portal 열기 | 카드 업데이트, 청구서 확인, 플랜 변경 |
| Resume Subscription | 구독이 취소된 경우에만 표시 | 등록된 카드로 재활성화 |
Billing 페이지 이해하기
Current Plan
이 카드에는 활성 구독이 표시됩니다:
- Plan name — 배지로 표시됩니다 (예: "AVA Standard")
- Price — 통화가 포함된 월간 또는 연간 총액
- Price breakdown — 플랜에 여러 구성 요소가 있는 경우 (예: 기본 요금 + 객실당 요금) 각 항목이 나열됩니다
- Plan code — 플랜의 내부 코드 (예:
AVA-STANDARD) - Trial ends — 활성 체험 기간 중에만 표시됩니다
Status
이 카드에는 결제 일정이 표시됩니다:
| 필드 | 의미 |
|---|---|
| Next charge | 다음에 카드가 청구될 날짜 |
| Last payment | 가장 최근에 성공한 결제 날짜 |
| Overdue since | 결제에 실패한 경우 표시되며 잔액이 연체되기 시작한 시점을 보여줍니다 |
| Grace deadline | 연체된 경우 정지 전에 결제해야 하는 날짜 |
오른쪽 상단의 상태 배지에는 현재 상태가 표시됩니다:
- Active — 구독이 최신 상태이며 결제가 완료됨
- Trial — 무료 체험 기간 진행 중
- Past Due — 결제에 실패했지만 아직 유예 기간 내임
- Grace Period — 실패한 결제를 해결할 수 있는 마지막 기간
- Canceled — 구독이 취소됨 (재개 가능)
- Suspended — 미결제로 인해 계정이 제한됨
Payment Method
이 섹션에는 정기 청구에 저장된 카드가 표시됩니다:
- 카드 브랜드 (예: VISA, MASTERCARD)
- 끝 4자리 (예: •••• 4242)
- 만료일 (예: Exp 08/2027)
등록된 카드가 없으면 **"No payment method on file."**이 표시됩니다.
결제 카드 업데이트 방법
-
Settings → Billing으로 이동합니다.
-
Payment Method 섹션에서 Manage Subscription을 클릭합니다.
-
브라우저에서 Stripe Billing Portal이 열립니다.
-
Stripe에서 Payment methods 또는 Update payment method를 선택합니다.
-
새 카드 정보를 입력하고 저장합니다.
-
Stripe 탭을 닫고 AVA로 돌아옵니다.
-
Billing 페이지에서 Refresh를 클릭하여 업데이트된 카드를 확인합니다.
✓ 새 카드 브랜드, 끝 4자리, 만료일이 표시되어야 합니다.
Stripe Billing Portal은 Stripe가 호스팅하는 보안 페이지입니다. AVA는 전체 카드 번호를 저장하지 않으며 카드 브랜드, 끝 4자리, 만료일만 표시합니다.
청구서 및 결제 내역 확인 방법
-
Settings → Billing으로 이동합니다.
-
Manage Subscription을 클릭합니다.
-
Stripe Billing Portal에서 Billing history 또는 Invoices를 선택합니다.
-
과거 청구서를 다운로드하거나 확인합니다.
✓ 청구서에는 금액, 날짜, 사용한 결제 수단이 포함됩니다.
플랜 변경 또는 업그레이드 방법
-
Settings → Billing으로 이동합니다.
-
Manage Subscription을 클릭합니다.
-
Stripe Billing Portal에서 Update plan을 선택합니다.
-
새 플랜을 선택하고 확인합니다.
-
AVA로 돌아와 Refresh를 클릭합니다.
✓ Current Plan 카드에 새 플랜 이름과 가격이 표시되어야 합니다.
Manage Subscription 버튼 아래에 *"To upgrade or change your plan, open the Stripe Billing Portal."*이라는 안내가 표시됩니다. 이 안내를 따라 플랜을 변경하세요.
취소된 구독 재개 방법
구독이 취소되면 Manage Subscription 옆에 녹색 Resume subscription 버튼이 표시됩니다.
-
Settings → Billing으로 이동합니다.
-
등록된 카드가 있는지 확인합니다 (Payment Method 섹션에 표시됨).
-
Resume subscription을 클릭합니다.
✓ 상태가 Active로 변경되고 Resume 버튼이 사라져야 합니다.
등록된 결제 카드가 없으면 Resume 버튼이 비활성화됩니다. 먼저 카드를 추가하세요:
- Manage Subscription을 클릭하여 Stripe를 엽니다.
- 결제 카드를 추가합니다.
- AVA로 돌아와 Resume subscription을 클릭합니다.
요금 알림 이해하기
조치가 필요할 때 AVA는 페이지 상단에 요금 배너를 표시합니다:
| 배너 색상 | 심각도 | 의미 |
|---|---|---|
| Blue | 정보 | 일반적인 요금 정보 (예: 체험 상태) |
| Amber | 경고 | 곧 조치 필요 (예: 결제 연체) |
| Red | 위험 | 긴급 조치 필요 (예: 유예 기간 종료 임박) |
일부 배너에는 Stripe를 직접 여는 Manage billing 버튼이 포함됩니다.
계정 정지
미결제로 인해 계정이 suspended되면 Update payment method 버튼이 있는 전체 화면 오버레이가 나타납니다. AVA를 사용하려면 결제 문제를 해결해야 합니다.
- 오버레이에서 Update payment method를 클릭합니다.
- Stripe에서 유효한 카드를 업데이트하거나 추가합니다.
- AVA로 돌아옵니다 — 결제가 확인되면 오버레이가 사라집니다.
무료 티어와 유료 플랜
티어는 자동으로 결정됩니다:
- Free tier — 등록된 결제 카드가 없고 활성 구독이나 체험이 없음
- Paid tier — 활성 구독, 활성 체험 또는 카드가 등록된 체험
| 기능 | 무료 티어 | 유료 플랜 |
|---|---|---|
| Guest activity logs | 최근 20개 로그만 | 전체 기록 |
| Analytics dashboard | 사용 불가 | 사용 가능 |
| Reports (including compliance) | 사용 불가 | 사용 가능 |
| Guest WhatsApp + AI chatbot | 사용 불가 | 사용 가능 |
| Staff activity history | 사용 불가 | 사용 가능 |
| Guest ↔ Staff video call | 사용 불가 | 사용 가능 |
무료 티어에서 잠긴 기능에는 Billing 페이지로 연결되는 업그레이드 안내가 표시됩니다.
조직 컨텍스트와 호텔 요금
호텔 요금은 개별 호텔이 활성화된 경우에만 적용됩니다.
Organization이 활성화되면 AVA는 호텔 요금 상태를 로드하지 않습니다. 또한 호텔 요금 제한이나 경고도 표시하지 않습니다.
요금을 확인하거나 관리하려면:
- Hotel Switcher를 엽니다.
- 개별 호텔을 선택합니다.
- Settings → Billing을 엽니다.
Organization으로 전환하면 이전 호텔 요금 경고가 즉시 사라집니다.
요금 상태 새로고침
요금 상태는 다음과 같은 경우 자동으로 새로고침됩니다:
- 로그인할 때
- 개별 호텔로 전환할 때
- 이전에 유휴 상태였던 탭으로 돌아올 때
수동으로 새로고침하려면:
-
Settings → Billing으로 이동합니다.
-
오른쪽 상단의 Refresh 버튼을 클릭합니다.
✓ 플랜, 상태, 카드 정보가 몇 초 내에 업데이트됩니다.
문제 해결
Manage Subscription 버튼이 비활성화됨
증상: Manage Subscription 버튼이 회색으로 표시되거나 "Portal unavailable"이라고 표시됩니다.
해결:
- 계정에 Admin (Billing) 권한이 있는지 확인합니다.
- 버튼에 **"Managed by admin"**이 표시되면 Vouch 담당자가 요금을 관리하는 것입니다 — 변경하려면 담당자에게 문의하세요.
- 페이지를 새로고침하고 다시 시도합니다.
Resume 버튼이 비활성화됨
증상: Resume subscription이 회색으로 표시됩니다.
해결:
- Manage Subscription을 클릭하여 Stripe를 엽니다.
- 결제 카드를 추가합니다.
- AVA로 돌아와 Resume subscription을 클릭합니다.
Stripe에서 변경한 카드 정보가 업데이트되지 않음
증상: Stripe에서 카드를 업데이트했지만 AVA에는 여전히 이전 카드가 표시됩니다.
해결:
- Billing 페이지에서 Refresh를 클릭합니다.
- 캐시가 삭제될 때까지 최대 30초 기다립니다.
- 여전히 최신 정보가 아니면 Billing 페이지를 닫았다가 다시 엽니다.
탭 전환 후 요금 상태가 잘못 표시됨
증상: 유휴 탭으로 돌아온 후 Billing에 잘못된 플랜이나 상태가 표시됩니다.
해결:
-
Billing 페이지에 10초 동안 머뭅니다 — AVA가 백그라운드에서 재동기화합니다.
-
상태가 여전히 잘못 표시되면 Refresh를 클릭합니다.
✓ 탭이 활성화되면 Billing이 자동으로 재동기화됩니다.
"Billing not configured"가 잠시 표시됨
증상: 탭으로 돌아올 때 "Billing not configured"가 잠시 깜박입니다.
해결:
- 탭에서 10초 동안 기다립니다.
- 요금 카드가 자동으로 업데이트됩니다.
- 메시지가 계속 표시될 때만 한 번 새로고침합니다.
업그레이드 후에도 기능이 잠겨 있음
증상: 카드를 추가하거나 업그레이드했지만 기능이 여전히 잠긴 것으로 표시됩니다.
해결:
- Settings → Billing으로 이동합니다.
- Refresh를 클릭하고 상태가 Active로 표시되는지 확인합니다.
- 잠긴 기능으로 이동하여 해당 페이지를 새로고침합니다.
- 여전히 잠겨 있으면 로그아웃한 후 다시 로그인합니다.
전체 화면 정지 오버레이가 사라지지 않음
증상: 결제 업데이트 후에도 빨간색 정지 오버레이가 남아 있습니다.
해결:
- Billing 페이지에서 Refresh를 클릭합니다.
- 오버레이가 계속 표시되면 브라우저 페이지를 새로고침합니다.
- Stripe에서 결제가 성공적으로 처리되었는지 확인합니다.
Organization 컨텍스트에 호텔 요금 경고가 표시됨
증상: Organization으로 전환한 후에도 호텔 요금 제한이 남아 있습니다.
해결:
-
브라우저 페이지를 새로고침합니다.
-
Organization이 여전히 활성 컨텍스트인지 확인합니다.
-
경고가 계속 표시되면 호텔로 전환했다가 다시 Organization으로 전환합니다.
✓ Organization 컨텍스트에는 호텔 요금 상태나 기능 잠금이 표시되지 않아야 합니다.
관련 가이드
아직 해결되지 않았나요?
다음과 같은 경우 success@vouch-technologies.com으로 문의하세요:
- ❌ Billing 페이지에 액세스할 수 없음
- ❌ Stripe에서 업데이트한 카드가 AVA에 반영되지 않음
- ❌ 결제 후 구독 상태에 오류가 표시됨
- ❌ 정지 오버레이가 사라지지 않음
다음 정보를 함께 제공하면 도움이 됩니다:
- Billing 페이지 스크린샷
- 호텔 이름
- 문제가 시작된 시간
- 카드 끝 4자리 (관련 있는 경우)