# Billing

Manage your organization's billing, subscription plans, payment methods, and invoices

Source: https://docs.eugo.io/docs/platform/billing/

---

Manage your organization's subscription plans, payment methods, credits, and billing history.

## Overview

The platform uses a hybrid pricing model:

- **Base subscription fees**: Monthly plan costs (Standard, Premium, or Enterprise)
- **Usage-based billing**: Pay-as-you-go charges for compute, storage, and data transfer
- **Prepaid credits**: Optional credit balance to cover usage costs

Automatic monthly invoices are generated on the 1st of each month.

## Billing Dashboard

### Current Billing

Shows your current month's charges with comparison to last month:

- **Current Month Charges**: Accumulated billing for the current period
- **Percentage Change**: Comparison to previous month (green = decrease, red = increase)
- **Last Month Total**: Previous month's final amount

### Available Credits

Displays your prepaid credit balance and payment method. Credits are automatically deducted as you consume resources. When depleted, charges bill directly to your payment method.

### Current Plan

Shows your active subscription tier, monthly price, and limits (users, GPUs). Click **Manage Subscription** to change plans.

### Monthly Usage Summary

Interactive chart showing historical billing amounts and trends. Helps forecast costs and identify patterns.

### Monthly Invoice Breakdown

Detailed cost breakdown by workspace and resource type for any billing period.

**Resource Categories:**
- **Platform**: Base platform fees
- **ECU**: Standard compute units
- **ECU-E**: Enhanced compute units
- **ECU-G**: GPU compute units
- **S3**: Object storage
- **EBS**: Block storage
- **EFS**: File system storage
- **Other**: Miscellaneous charges

**Cost Summary:**
- Gross Cost → Net Before Tax → Tax → Total

### Invoice History

All generated invoices with payment status and actions.

| Column | Description |
|--------|-------------|
| **Invoice Number** | Unique identifier |
| **Month** | Billing period (YYYY-MM) |
| **Invoice Date** | Issue date |
| **Amount** | Total in USD |
| **Status** | Pending, Issued, Paid, Failed, Overdue, Void, Refunded |
| **Actions** | Download PDF, Pay Now |

### Recent Transactions

Latest payment activity showing payment method, description, date, amount, and status. Failed transactions show error details on hover.

## Subscription Plans

Three subscription tiers with unlimited storage and pay-as-you-go compute resources.

| Feature | Standard | Premium | Enterprise |
|---------|----------|---------|------------|
| **Base Price** | $250/month | $350/month | $550/month |
| **Active Users** | 3 | 10 | 30 |
| **GPUs/Workspace** | 1 | 8 | 16+ |
| **Support** | Standard | Priority | 24/7 Dedicated |
| **Cluster Monitoring** | Basic | Enhanced | Enhanced |
| **Security** | Standard | Standard | Advanced |

**Standard Plan** - For individuals and small teams  
**Premium Plan** (Most Popular) - For data science teams running ML/AI workloads  
**Enterprise Plan** - For large teams with mission-critical workloads

:::note
Custom pricing available for Enterprise customers. Contact sales for details.
:::

## Managing Subscription Plans

### Changing Your Plan

1. Click **Manage Subscription** in the Current Plan section
2. Select your desired plan
3. Review charges/credits (prorated for current billing period)
4. Click **Confirm**

**Changes take effect immediately:**
- **Upgrades**: Charged prorated difference
- **Downgrades**: Credit applied for unused portion
- **Limits**: New user/GPU limits apply instantly

:::warning
When downgrading, ensure workspaces and users are within new plan limits.
:::

All plan changes are logged in [Activity Logs](./activity-logs.md).

## Payment Methods

Eugo uses Stripe for secure payment processing. All major credit and debit cards accepted (Visa, Mastercard, Amex, Discover).

### Adding a Payment Method

1. In the **Available Credits** section, click the payment method card
2. Enter card details in the secure Stripe form
3. Click **Save Card**

Card details are never stored by Eugo.

**Processing Fee:** 2.9% + $0.30 per transaction (USD only)

## Credit System

Prepaid credits provide flexibility for managing compute costs.

### How It Works

1. Purchase credits using your payment method
2. Credits deduct automatically as resources are consumed (hourly calculation)
3. When exhausted, charges bill directly to payment method
4. If payment fails, services continue for 3-day grace period before suspension

### Adding Credits

1. Click the **+** button in the **Available Credits** section
2. Select amount: $300, $500, $1,000, $3,000, or $5,000
3. Review total including processing fee
4. Click **Confirm Payment**

### Credit Notifications

Email notifications sent at key thresholds:
- **Low Balance**: When credit usage exceeds 80%
- **Insufficient Credits**: Balance reaches zero
- **Credits Added**: Confirmation with transaction ID

## Invoicing

Invoices are automatically generated on the 1st of each month, covering the previous month's usage.

### Invoice Components

- Base subscription fee
- Workspace charges (compute, storage, data transfer)
- Gross cost → Net before tax → Tax → Total due

### Invoice Statuses

- **Pending**: Generated but not yet due (typically current month's accumulating charges)
- **Issued**: Due and ready for payment
- **Paid**: Successfully processed
- **Failed**: Payment unsuccessful, retry available
- **Overdue**: Invoice past due date
- **Void**: Invoice voided for audit purposes
- **Refunded**: Invoice refunded

### Downloading Invoices

Click the **Download** button in the Invoice History section. PDF includes organization details, billing period, itemized charges, and tax calculations.

### Manual Payment

For invoices with status "Issued" or "Failed", click **Pay Now** to process payment immediately.

All invoices are permanently retained for accounting and compliance.

## Billing Calculation

```
Total Monthly Bill = Base Plan Cost + Usage Costs + Taxes
```

### Usage Costs

**Compute:**
- **ECU**: Standard compute (per hour)
- **ECU-G**: GPU compute (per GPU-hour)
- **ECU-E**: Enhanced compute (per hour)

**Storage:**
- **S3**: Object storage (per GB/month)
- **EBS**: Block storage (per GB/month)
- **EFS**: File system storage (per GB/month)

**Other:** Data transfer, network egress

### Billing Cycle

- Billing period: 1st to last day of each month
- Base fee charged at month start
- Usage charges accumulate throughout month
- Invoice generated on 1st of following month
- Payment processed automatically within 1-2 days

Dashboard shows current month charges in real-time (updated hourly).

## Payment History

### Transaction Types

- **Credit Additions**: Manual credit purchases (includes processing fees)
- **Subscription Payments**: Monthly base subscription fees
- **Invoice Payments**: Automatic or manual invoice payments
- **Refunds**: Credits for plan downgrades or service issues

### Failed Transactions

Common causes: insufficient funds, expired card, incorrect billing info, bank fraud protection.

**Resolution:**
1. Email notification sent to billing contacts
2. Update payment method
3. Retry payment
4. 3-day grace period before service suspension

Shows 5 most recent transactions with pagination for history.

## Access Control

Only **Organization Owners** have access to billing information and can perform all billing-related actions:

- View billing dashboard and invoices
- Download invoices
- Add credits
- Update payment method
- Change subscription plan

Users without the Organization Owner role cannot access billing information. All billing actions are logged in [Activity Logs](./activity-logs.md).

## Email Notifications

Automatic notifications sent for critical billing events:

- **Payment Received/Failed**: Transaction confirmation or failure details
- **Invoice Issued**: Monthly invoice with payment due date
- **Low Credits**: Alert when credit usage exceeds 80%
- **Insufficient Credits**: Alert when balance reaches zero
- **Service Suspension/Resumed**: Service status changes

**Recipients:** Organization owner and additional configured emails.

Configure additional email addresses in [Organization Settings](./organization-settings.md) → Notifications.

## Service Suspension

### Triggers

- Credits exhausted + no valid payment method
- Credits exhausted + payment failure
- Failed invoice payment after multiple retries

**Grace Period:** 3 days with daily reminder emails

### During Suspension

- Cannot create or deploy workspaces
- Running workspaces terminated
- All data and configurations preserved
- Billing dashboard accessible

### Restoration

1. Add credits or update payment method
2. Services resume automatically
3. Redeploy workspaces manually

## Troubleshooting

### Payment Declined

**Common causes:** Insufficient funds, expired card, incorrect billing info, bank fraud protection

**Solutions:** Verify card details, contact bank, try different payment method, or contact support

### Service Suspended

**Resolution:** Add credits or update payment method → services restore automatically → redeploy workspaces

### Unexpected Charges

Review Monthly Invoice Breakdown → check [Activity Logs](./activity-logs.md) for workspace activity → contact support (ben@eugo.io) with invoice number

### Unable to Change Plan

**Causes:** Unpaid invoices, workspaces exceed new limits, insufficient permissions (Owner role required)

**Solutions:** Pay outstanding invoices, adjust workspace configurations, or verify permissions

## Best Practices

**Cost Management:**
- Review billing dashboard weekly for unexpected spikes
- Use Monthly Invoice Breakdown to identify high-cost workspaces
- Right-size GPU allocations and terminate idle workspaces
- Enable low credit balance notifications

**Payment Management:**
- Keep payment method current to avoid service interruptions
- Maintain 1-2 months of average usage in credit balance
- Review transaction history monthly
- Download invoice PDFs for records

**Plan Optimization:**
- Review plan limits monthly against actual usage
- Upgrade proactively before hitting limits
- Consider downgrading if consistently under limits
- Contact sales for enterprise pricing

## Getting Help

Contact: ben@eugo.io

**Support Levels:**
- **Standard**: Email (9am-5pm ET)
- **Premium**: Priority email
- **Enterprise**: 24/7 email, chat, phone

Include: Organization ID, invoice/transaction number, issue description, and screenshots.

## Related Resources

- [Dashboard](./dashboard.md) - View high-level billing information alongside other metrics
- [Activity Logs](./activity-logs.md) - Audit trail of billing-related actions
- [Organizations](./organizations.md) - Manage organization settings and details
- [Organization Settings](./organization-settings.md) - Configure billing notification preferences
- [Workspaces](./workspaces.md) - Understand workspace resource usage and billing impact