> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alana.shopping/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing & Plans

> Subscription plans, usage limits, and billing management.

## Plans

| Feature                 | Standard |   Pro  | Business | Enterprise |
| ----------------------- | :------: | :----: | :------: | :--------: |
| SKU limit               |   1,000  | 10,000 |  50,000  |  Unlimited |
| AI credits/month        |    100   |  1,000 |   5,000  |   Custom   |
| Concurrent fast jobs    |     1    |    3   |     5    |   Custom   |
| Concurrent relaxed jobs |     2    |    5   |    10    |   Custom   |
| Members                 |     3    |   10   |    25    |  Unlimited |
| Brands                  |     1    |    5   |    20    |  Unlimited |
| Priority support        |    No    |   Yes  |    Yes   |     Yes    |

## Managing subscriptions

### Upgrade or change plan

Create a Stripe Checkout session to upgrade:

```bash theme={null}
curl -X POST ".../billing/checkout" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan": "pro", "successUrl": "https://...", "cancelUrl": "https://..."}'
```

### Customer portal

Redirect to Stripe's self-service portal for invoice history, payment method changes, and plan cancellation:

```bash theme={null}
curl "https://app.alana.shopping/api/workspace/{workspaceId}/billing/portal" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Usage tracking

Monitor your workspace's resource consumption:

```bash theme={null}
curl ".../billing/usage" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Returns monthly usage broken down by SKU count, AI credits consumed, and API calls.

## Usage alerts

Set up alerts to get notified before hitting plan limits:

```bash theme={null}
curl -X PATCH ".../billing/alerts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "alerts": [
      {"metric": "skus", "threshold_percent": 80, "enabled": true},
      {"metric": "ai_credits", "threshold_percent": 90, "enabled": true}
    ]
  }'
```

<Info>
  Usage alerts are sent via email to the billing contact. Set the billing contact at **Settings > Billing > Contact**.
</Info>