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

# Choose a plan, and see invoices and payments

> Choose a plan or start the 14-day trial with Stripe Checkout, and change the plan in the Stripe Customer Portal. See the billing info, the cards, the invoices, and the charges of the workspace.

A workspace pays for one plan. Use **Billing** to choose a plan, start the trial, see the invoices and the payments, and change the card or the billing info.

Help me choose a plan.

Ask how many sandboxes my agents run at a time and how many they start each minute.
Use the plans reference to suggest the smallest plan that is sufficient.
Tell me if the trial is enough to test first.

## Before you start

* You need the **Owner** or **Admin** role to choose a plan, start the trial, or open the billing portal. Each member can see the plan, the billing info, the cards, the invoices, and the charges. See [roles](https://vms.dev/docs/reference/workspace-access.md#roles).
* Members are free. The plan price does not change when you add members.
* Have a card ready. The trial also needs a card.

## What the Billing page shows

To open the page, choose **Settings** in the rail, then **Billing**. The page has these cards, from top to bottom:

| Card | Shows |
| - | - |
| **Overview** | The plan, its status (**Trial**, **Active**, or **Past due**), the date when the trial ends or the plan renews, the total spend of this month, the sandboxes at a time, and the starts each minute. With a plan, it has **Change plan**. With no plan, it has **Choose a plan**. |
| **Balances** | The credit and the balance, with their breakdown and expiration. See [Top up the balance, and see the usage](https://vms.dev/docs/workspace/usage-and-balance.md). |
| **Billing info** | The name, the email, the phone, and the address on your invoices and receipts. |
| **Payment methods** | The cards that you saved, with the brand, the last 4 digits, and the expiry. Each card shows one time, also if you entered it on more than one Stripe page. The card that pays each invoice shows **Default**. |
| **Automatic top-up** and **One-time top-up** | Add money to the balance. See [Top up the balance](https://vms.dev/docs/workspace/usage-and-balance.md#top-up-the-balance). |
| **Spending limit** | The monthly spending limit. See [Set a spending limit](https://vms.dev/docs/workspace/usage-and-balance.md#set-a-spending-limit). |
| **Member caps** | The sandboxes and the unit-hours of each member, and their caps. See [Cap the use of each member](https://vms.dev/docs/workspace/usage-and-balance.md#cap-the-use-of-each-member). |
| **Usage this month** and **Cost by label** | The cost of each sandbox and each label this month, with a CSV export. |
| **Invoices** | The invoices of the workspace: the number, the status, the type, the amount, the date, and the due date. |
| **Charges** | Each payment attempt, also the failed and the refunded ones. |

**Payment methods**, **Invoices**, and **Charges** read Stripe again when you come back to the tab.

![The Overview card with the \$20 plan in trial, the trial end date, the spend this month, the limits, and the Change plan button.](https://mintcdn.com/vms-c6f4e5ac/kvsBm-leIVQYZQAw/images/workspace/billing/00-overview-light.png?fit=max\&auto=format\&n=kvsBm-leIVQYZQAw\&q=85\&s=66ddc8c40b2269bb07182d717b933cc1)

![The Payment methods card with one Visa card that ends in 4242, marked Default, and the Edit button.](https://mintcdn.com/vms-c6f4e5ac/kvsBm-leIVQYZQAw/images/workspace/billing/01-payment-methods-light.png?fit=max\&auto=format\&n=kvsBm-leIVQYZQAw\&q=85\&s=826f562196e61fe2d82d6223873eaf6b)

## Start the trial

1. In the rail, choose **Settings**, then **Billing**.
2. In **Overview**, choose **Choose a plan**, then **14-day trial**.
3. On the Stripe page, enter your card and confirm. Stripe shows your email. You can add a tax ID, such as a VAT number, for your invoices. Stripe sends you back to **Billing**.

**Overview** shows \*\*$20 plan**, the status **Trial**, and the date when the trial ends. At that date, the $20 plan starts and Stripe charges the card. To stop before that date, cancel in the billing portal.

Each workspace gets one trial. Each owner also gets one trial, also in a different workspace. See the [trial limits](https://vms.dev/docs/reference/plans.md#trial).

## Choose a plan

1. In the rail, choose **Settings**, then **Billing**.
2. In **Overview**, choose **Choose a plan**, then the plan.
3. On the Stripe page, enter your card and confirm. Stripe sends you back to **Billing**.

**Overview** shows the plan, the date when it renews, and its main limits. See the [limits of each plan](https://vms.dev/docs/reference/plans.md#plans).

## Change the plan

1. In the rail, choose **Settings**, then **Billing**.
2. In **Overview**, choose **Change plan**. The Stripe billing portal opens on the list of plans.
3. Choose the new plan, and confirm. Stripe sends you back to **Billing**.

**Overview** shows the new plan and its limits. A change during the trial ends the trial, and Stripe charges the card for the new plan.

To cancel the plan, choose **Edit** in **Billing info** or **Payment methods**, and cancel in the billing portal. A canceled plan stays until the end of the month that you paid for. **Overview** shows the date when it ends.

## Change the plan, the card, or the billing email

1. In the rail, choose **Settings**, then **Billing**.
2. To change the name, the email, the phone, or the address, choose **Edit** in **Billing info**. To add a card or change the default card, choose **Edit** in **Payment methods**. The Stripe billing portal opens.
3. Make the change.
4. Choose the return link to go back to **Billing**. The cards show the change.

## Download an invoice

1. In the rail, choose **Settings**, then **Billing**.
2. In **Invoices**, find the invoice. You can search, sort each column, and go to the next page.
3. Choose the actions button at the end of the row, then **Download PDF**.

The type of an invoice is **Plan** for the monthly plan fee, or **One-time** for a different payment. **Invoices** shows the 100 newest invoices. To see older invoices, open the billing portal.

## See the payments

**Charges** shows each payment attempt on your cards, newest first. The status is **Paid**, **Pending**, **Failed**, or **Refunded**. To open the receipt of a payment, choose the actions button at the end of the row, then **View receipt**. **Charges** shows the 100 newest payments.

## If a payment fails

**Overview** shows **Past due** and **The last payment failed. Update your card.** Choose **Edit** in **Payment methods**, and add a different card. Stripe tries the payment again. **Charges** shows the failed payment.

If a payment has a dispute or a fraud warning, **Billing** shows that the payment needs a check. New sandboxes cannot start until the check is done.

Read the [changelog.](https://vms.dev/docs/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.