# Manage billing

Use **Settings > Usage & Billing** to review the account's current plan, compare plans, purchase add-on minutes, and manage scheduled plan changes.

## Open Usage & Billing

1. Sign in to TestVibe.
2. Load the workspace for the repository you want to review.
3. Open **Settings** from the left navigation.
4. Select **Usage & Billing**.

The page shows account context, plan usage, credit information, plan cards, and GitHub API quota when available.

## Review Usage

| Area             | What it means                                                                                   |
| ---------------- | ----------------------------------------------------------------------------------------------- |
| Your plan        | Current plan, included minutes, billable minutes used, and billing-period reset.                |
| Credit           | Purchased add-on minutes, remaining purchased balance, and purchase controls for metered plans. |
| Repository usage | Billable minutes attributed to the active repository.                                           |
| GitHub usage     | GitHub API quota for the active GitHub context. This is not TestVibe billing usage.             |

## Change Plans

Plan cards show the available actions for the current account.

| Action                  | What happens                                                                 |
| ----------------------- | ---------------------------------------------------------------------------- |
| Current Plan            | The plan is already active and no immediate action is needed.                |
| Upgrade Now             | The higher-tier plan starts immediately.                                     |
| Downgrade               | The lower-tier plan is scheduled for the next billing period.                |
| Change Schedule         | Replaces an existing scheduled downgrade with a different lower-tier target. |
| Cancel Scheduled Change | Keeps the current plan active and removes the pending downgrade.             |

Paid plan changes open a Stripe Checkout session in a new browser tab when payment confirmation is required. After checkout completes, return to TestVibe; the billing summary refreshes periodically and should show the updated plan or credit balance.

## Buy Add-on Minutes

Metered plans can buy one or more 1,000-minute packs. Enter the quantity, then use the purchase action in the **Credit** card. Purchased minutes are consumed after included plan minutes.

Add-on minute purchase controls are disabled while Unlimited is active because Unlimited already includes unlimited TestVibe minutes.

## Troubleshooting Billing State

| Situation                                       | What to check                                                                                                  |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| A checkout finished but the plan did not update | Wait for the billing summary refresh, then reload **Settings > Usage & Billing**.                              |
| A downgrade is still shown                      | Downgrades are scheduled and start on the next billing-period date shown on the page.                          |
| Add-on minute purchase is unavailable           | Confirm the current plan is not Unlimited and that the billing page has finished loading.                      |
| GitHub quota is low                             | GitHub quota is separate from TestVibe plan minutes; wait for GitHub quota reset or reduce repository polling. |

For the plan table, see [Plans](/pricing/plans.md). For minute calculations, see [Billable minutes and credit](/pricing/billable-minutes-and-credit.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.testvibe.com/pricing/manage-billing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.