Subscription Management

View and manage your Xermius subscription, upgrade or downgrade plans, and understand your benefits.

Current Plan

View Plan Details

┌────────────────────────────────────┐
│ Current Plan: Pro                  │
├────────────────────────────────────┤
│ $29/month                          │
│ Billed monthly                     │
│ Next billing: Feb 1, 2024         │
│                                    │
│ Included Features:                 │
│ ✓ Unlimited hosts                  │
│ ✓ 10 devices                       │
│ ✓ 1 GB cloud storage              │
│ ✓ Cloud sync                       │
│ ✓ Priority support                 │
│ ✓ Advanced features                │
│                                    │
│ [Upgrade] [Change Plan] [Cancel]   │
└────────────────────────────────────┘

Available Plans

Free Plan

Free - $0/month

Features:
✓ 10 hosts
✓ 2 devices
✓ 100 MB storage
✓ Local use only
✓ Community support

Best for: Personal use, testing

[Downgrade to Free]

Pro Plan

Pro - $29/month or $290/year

Features:
✓ Unlimited hosts
✓ 10 devices
✓ 1 GB storage
✓ Cloud sync
✓ Priority support
✓ Advanced features
✓ No ads

Best for: Power users, freelancers

[Select Pro]

Feature Comparison

Feature	Free	Pro
Hosts	10	Unlimited
Devices	2	10
Storage	100 MB	1 GB
Cloud Sync	❌	✅
Support	Community	Priority
Price	Free	$29/mo

Upgrading

Upgrade Process

1. Click [Upgrade]
2. Select plan
3. Choose billing:
   ○ Monthly
   ○ Annual (save 17%)
4. Enter payment
5. Confirm

Instant upgrade!

Billing Cycle

Monthly:

$29/month
Billed monthly
Cancel anytime

Annual:

$290/year (save $58!)
Billed once a year
2 months free

Proration

Mid-cycle upgrade:

Upgraded on Jan 15
Next billing: Feb 1

Credit: $14.50 (unused Free days)
Applied: To first Pro payment

Fair pricing!

Downgrading

Downgrade Process

1. Settings → Subscription
2. [Change Plan]
3. Select Freemium plan
4. Confirm downgrade

What happens immediately:
- Subscription marked as "downgraded"
- You KEEP all PRO features
- Access continues until period ends
- Can resume PRO anytime before expiry

Important: You Keep PRO Access!

When you downgrade to Freemium:

✅ Immediate:
- Subscription marked as downgraded
- PRO features remain active
- Full access until period ends
- "Resume PRO Plan" button appears

✅ During remaining period:
- Use all PRO features normally
- Cloud sync still works
- Priority support active
- Can resume PRO anytime

❌ After period ends:
- Freemium plan activates
- Features limited to Freemium
- Data may need cleanup
- Can upgrade again anytime

Resume PRO Plan

Changed your mind? Resume easily:

Before period ends:
1. Go to Subscription page
2. Click [Resume PRO Plan]
3. Instant reactivation
4. No payment needed
5. Continue as PRO

Benefits:
- Keep your trial period
- No interruption
- Same billing date
- All features restored

Example Timeline:

Day 1: Subscribe to PRO (14-day trial)
Day 5: Downgrade to Freemium
      → PRO features still active
      → Can resume until Day 14

Day 8: Resume PRO Plan
      → Downgrade cancelled
      → Continue PRO until Day 14
      → Then normal billing starts

Alternative:
Day 5: Downgrade to Freemium
Day 14: Trial expires
       → Freemium activates
       → PRO features disabled

Data Limits

If over new limits:

Example: Pro → Free
Pro: Unlimited hosts
Free: 10 hosts limit

Options:
1. Delete extra hosts
2. Export and backup
3. Upgrade again

Grace period: 7 days

Cancellation vs Downgrade

Understanding the Difference

Two ways to stop PRO subscription:

1. Downgrade to Freemium (Recommended)

What it does:
- Marks subscription as downgraded
- Keeps PRO access until period ends
- Can resume PRO anytime before expiry
- No data loss
- Smooth transition

Best for:
- Temporary break from PRO
- Unsure about cancelling
- Want to keep options open
- Trial period users

2. Cancel Immediately (Permanent)

What it does:
- Stops PRO access immediately
- Cancels billing
- Cannot resume
- Must subscribe again
- Data kept for 90 days

Best for:
- Definitely leaving PRO
- Need immediate cancellation
- Switching to competitor
- Account closure

Cancel Subscription (Immediate)

Settings → Subscription → Cancel Immediately

⚠️ Cancel Subscription Immediately?

What happens:
- PRO access stops NOW
- Billing cancelled
- Cannot resume
- Must resubscribe to get PRO again

Data:
- Kept for 90 days
- Then deleted
- Export recommended

[Keep Subscription] [Cancel Immediately]

Comparison Table

Action	PRO Access	Can Resume	Billing	Best For
Downgrade to Freemium	Until period ends	✅ Yes	Stops at period end	Temporary break
Cancel Immediately	Stops now	❌ No	Stops now	Permanent exit

Reactivation After Cancellation

If you cancelled immediately:

Within 90 days:
1. Sign in
2. Subscribe to PRO again
3. Data restored
4. Fresh subscription starts

After 90 days:
- Data deleted
- Fresh start
- Import backup if needed

Usage & Limits

Current Usage

Usage Overview:

Hosts:
███████░░░ 25 / Unlimited

Devices:
███░░░░░░░ 3 / 10

Storage:
██░░░░░░░░ 2.3 MB / 1 GB

All within limits ✓

Approaching Limits

⚠️ Storage Limit Warning

Usage: 950 MB / 1 GB (95%)

Actions:
- Clean up old data
- Delete unused items
- Upgrade to Team (10 GB)

[Clean Up] [Upgrade]

Payment Schedule

Next Payment

Next Billing:
Date: Feb 1, 2024
Amount: $29.00
Method: •••• 4242

[Update Payment Method]

Payment History

Recent Payments:

Jan 1, 2024: $29.00 ✓ Paid
Dec 1, 2023: $29.00 ✓ Paid
Nov 1, 2023: $29.00 ✓ Paid

[View All Payments →]

Billing Issues

Failed Payment

⚠️ Payment Failed

Attempted: Jan 1, 2024
Amount: $29.00
Reason: Card declined

Actions:
1. Update payment method
2. Retry payment

Grace period: 7 days
Then: Service suspended

[Update Payment] [Retry]

Grace Period

During grace period:
- Full access continues
- Daily reminder emails
- Update payment method
- Automatic retry

After grace period:
- Service suspended
- Can't access features
- Update to restore

Enterprise Features

Custom Solutions

For enterprises:

✓ Volume licensing
✓ On-premise deployment
✓ Custom integrations
✓ SSO/SAML
✓ Audit logging
✓ Compliance support
✓ Training & onboarding
✓ SLA guarantees

[Contact Sales]

Sales Process

1. [Contact Sales]
2. Discovery call
3. Custom proposal
4. Security review
5. Contract signing
6. Implementation

Timeline: 2-4 weeks

FAQs

Q: Can I change plans anytime?

A: Yes!
Upgrade: Instant
Downgrade: End of period

Q: What if I exceed limits?

A: Soft limits first
- Warning notification
- 7-day grace period
- Then hard limit
- Or auto-upgrade option

Q: Annual vs monthly?

A: Annual saves 17%
$29/mo = $348/year
$290/year = Save $58

2 months free!

Q: Can I get refund?

A: Pro-rated refunds:
- Within 30 days
- Cancel anytime
- Unused time refunded
- No questions asked

Q: Do I keep data after cancel?

A: Yes, 90 days
- Full access
- Can export
- Reactivate anytime
- After 90: Deleted

Technical Details (For Developers)

Subscription States

Understanding subscription lifecycle:

State 1: Active PRO
- ends_at > now()
- canceled_at IS NULL
- cancels_at IS NULL
→ User has full PRO access

State 2: Downgraded (Still on PRO)
- ends_at > now()
- canceled_at IS NULL
- cancels_at IS NOT NULL
→ User has full PRO access
→ Can resume PRO
→ Will become Freemium after ends_at

State 3: Freemium
- No subscription record, OR
- ends_at <= now()
→ User has Freemium access only

State 4: Cancelled (Immediate)
- canceled_at IS NOT NULL
→ PRO access stopped immediately
→ Cannot resume

Database Fields

Subscription table fields:

-- Subscription lifecycle fields
starts_at       TIMESTAMP    -- Subscription start date
ends_at         TIMESTAMP    -- Subscription expiry date
trial_ends_at   TIMESTAMP    -- Trial period end date

-- Cancellation fields
cancels_at      TIMESTAMP    -- Downgrade to Freemium date
canceled_at     TIMESTAMP    -- Immediate cancellation date

-- Gateway tracking
gateway_type              VARCHAR  -- polar, stripe, paypal, internal
gateway_subscription_id   VARCHAR  -- Gateway subscription ID

Logic Rules

Key business rules:

1. Single Subscription Record
   - User can only have ONE PRO subscription
   - No separate Freemium subscription record
   - Freemium = no subscription OR expired subscription

2. Downgrade to Freemium
   - Set cancels_at = now()
   - Keep ends_at unchanged
   - User keeps PRO until ends_at
   - Can resume by clearing cancels_at

3. Resume PRO
   - Clear cancels_at field
   - Keep ends_at unchanged
   - User continues PRO subscription
   - No payment needed (already paid until ends_at)

4. Immediate Cancellation
   - Set canceled_at = now()
   - PRO access stops immediately
   - Cannot resume (must resubscribe)
   - Billing stops immediately

5. Freemium Check
   - No subscription exists, OR
   - ends_at IS NULL, OR
   - ends_at <= now()
   → User is on Freemium

6. Can Resume Check
   - cancels_at IS NOT NULL, AND
   - ends_at > now()
   → User can resume PRO

API Response Example

Subscription data structure:

{
  "subscription": {
    "id": 123,
    "plan": {
      "id": 2,
      "slug": "pro",
      "name": "Pro",
      "price": 25.00,
      "currency": "USD"
    },
    "created_at": "2024-01-01T00:00:00Z",
    "starts_at": "2024-01-01T00:00:00Z",
    "ends_at": "2024-01-15T00:00:00Z",
    "cancels_at": "2024-01-05T00:00:00Z",
    "trial_ends_at": "2024-01-15T00:00:00Z",
    "is_active": true,
    "is_canceled": false,
    "has_downgraded": true,
    "on_trial": true,
    "can_resume": true
  }
}

Field explanations:

• is_active: PRO subscription is active (ends_at > now)
• is_canceled: Immediate cancellation (canceled_at IS NOT NULL)
• has_downgraded: Downgraded to Freemium (cancels_at IS NOT NULL)
• can_resume: Can resume PRO (has_downgraded AND ends_at > now)

Next Steps

• 💰 Billing - Payment & invoices
• 📊 Dashboard - Account overview
• 📱 Devices - Device management
• 🎫 Support - Get help