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

# Billing

> Understand Scopy workspace billing: plans, how review credits are used, buying additional credits, and choosing a model billing mode per workspace or repository.

Billing is managed per workspace.

## Billing page

The billing area shows the selected workspace's current plan, credit balance, review history, and available subscription actions.

Depending on workspace state, you may see actions to:

* Subscribe to **Premium** or **Ultra**.
* Open the billing portal.
* Change plans.
* Cancel a subscription.
* Contact the founder about **Enterprise**.

Billing changes apply to the selected workspace, not to every workspace connected to your user account.

## Plans

| Plan           | Price         | Included credits                                 |
| -------------- | ------------- | ------------------------------------------------ |
| **Free**       | \$0           | No included credits — add a plan to start review |
| **Premium**    | \$19.99/month | 25 review credits per month                      |
| **Ultra**      | \$99.99/month | 150 review credits per month                     |
| **Enterprise** | Custom        | Custom credit volume, onboarding, and support    |

The Free plan lets you connect GitHub and set up repositories, but managed cloud reviews need credits. Choose a monthly plan to start reviewing pull requests.

**Enterprise** is handled manually: you can always email founder at [matt@scopy.dev](mailto:matt@scopy.dev?subject=Enterprise%20plan) with any questions.

## How credits are used

Every review costs credits based on how much the pull request changes. Most pull requests cost a single credit, and larger ones cost more.

* Paid monthly plans include a credit allowance that resets each billing period.
* When a workspace runs out of credits, new reviews are skipped until you top up or the next billing reset.

## Buying additional credits

On a paid plan, workspace owners can buy extra credits any time from the billing page — useful for a busy month without changing plans. Credits are priced per plan: **$1.00 each on Premium** and **$0.80 each on Ultra**. Purchased credits are added on top of your monthly allowance.

## Model billing mode

Each workspace chooses how model usage is paid for, from **Settings → Model billing**:

* **Platform billing** (default): reviews run on Scopy's provider keys and consume your workspace credits.
* **Bring your own key**: reviews use your own OpenRouter or Vercel AI Gateway key. Model usage is billed directly to your provider account and is **not** charged to workspace credits.

To enable bring-your-own-key, choose **Bring your own key** and paste an **OpenRouter** or **Vercel AI Gateway** key. You can replace or remove a key at any time.

If you store both keys, choose which one reviews use, or leave it on **Automatic** (which prefers OpenRouter).

### Per-repository override

The workspace setting is the default for every repository. Any repository can override it from its own **Model billing** settings — for example, keep the workspace on platform billing but run one repository on your own key. An explicit repository choice stays fixed even if the workspace default changes later.

If a repository is set to bring-your-own-key but no key is configured, its reviews are skipped with a note on the pull request until you add a key or switch it back to platform billing.