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

# Billing Overview

> How Nearbase billing works — subscriptions, payment, and invoices

## How Billing Works

Nearbase uses a **monthly subscription** model. When you create an instance, you pay for the first full billing period upfront. Each month, the subscription automatically renews and the next period's fee is charged.

### Payment Priority

Payments follow this order:

1. **Promo credits** — If you have promotional credits in your account, they are applied first (until they expire or run out).
2. **Cash balance** — Any remaining amount is deducted from your account balance.
3. **Saved card** — If your balance is insufficient, the remaining amount is charged to your saved Stripe payment card.

<Tip>
  Top up your balance in advance to avoid relying on card charges at renewal
  time. See [Balance & Credits](/billing/balance-and-credits).
</Tip>

## Subscriptions

Each Nearbase instance is a separate subscription. You can view, manage, and cancel subscriptions from the **Billing → Subscriptions** page in the console.

### Subscription States

| State      | Description                                                                                                  |
| ---------- | ------------------------------------------------------------------------------------------------------------ |
| `active`   | Subscription is running and will renew at the end of the period.                                             |
| `canceled` | Subscription has been canceled and will not renew. The instance is deleted at the end of the current period. |

### Canceling a Subscription

When you delete an instance, its subscription is canceled. You receive a [prorated credit](/instances/lifecycle#prorated-refund) back to your account balance for the unused days remaining in the billing period.

## Invoices

Nearbase generates an invoice for each charge. You can view all invoices from the **Billing → Transactions** page. Each invoice includes:

* The billing period
* The instance name and region
* The amount charged
* A link to the Stripe receipt

## Upcoming Renewal

The console shows you the upcoming renewal amount for each active subscription so there are no surprises at renewal time.

## Failed Payments

If a renewal charge fails (insufficient balance and card decline), the subscription enters a past-due state. Nearbase will attempt to retry the charge. If payment cannot be collected, the instance will be suspended and eventually deleted. Ensure your [balance](/billing/balance-and-credits) is sufficient or keep a valid payment card on file.

Need help with a billing question? Contact [team@m.nearbase.dev](mailto:team@m.nearbase.dev).