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

# Understanding Your Plan Balance and Billing Period

> See how Palladium AI calculates your remaining plan balance using linear decay, and learn what the colour-coded balance indicator means for your team.

The billing balance card gives your team a real-time view of how much plan value remains in the current period. Palladium AI calculates your remaining balance continuously using a linear decay model — so the figure you see is always current and accurate at any moment.

<Note>
  Teams on the Pilot (free) plan see a **"Subscribe to a paid plan"** prompt instead of a balance card. The balance card is only shown for active paid subscriptions.
</Note>

## How the balance is calculated

Your remaining balance is derived from a straightforward formula:

```
remaining = planAmount × (1 − elapsed / periodMs)
```

* **`planAmount`** — the total value of your plan for the period (in Kwacha).
* **`elapsed`** — the number of milliseconds that have passed since your billing period started.
* **`periodMs`** — the total length of the billing period in milliseconds (30 days).

The balance starts at the full plan amount on day one and decays linearly to zero by the end of day 30. Because the calculation runs in real time, the card reflects your true remaining balance at any moment.

## Reading the balance card

The balance card uses a colour-coded progress bar to give you an immediate visual sense of where you are in the period:

| Colour       | Threshold                     | What it means                                                                                                         |
| ------------ | ----------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| 🟢 **Green** | Above 50% remaining           | Your balance is healthy — you are in the first half of your billing period.                                           |
| 🟡 **Amber** | Between 20% and 50% remaining | You are approaching mid-period. No action is needed, but it is a good time to review usage.                           |
| 🔴 **Red**   | Below 20% remaining           | You are near the end of your billing period. Consider whether your plan still meets your team's needs before renewal. |

Beneath the progress bar, the card displays two lines:

* **"K{remaining} of K{planAmount}"** — the exact calculated remaining value alongside your full plan amount.
* **Days remaining** and the period end date, so your finance team always knows when the next renewal falls.

## Billing period renewal

At the end of each 30-day billing period, a new period starts automatically. Active subscriptions advance to the next period, resetting the balance to the full plan amount and recording the renewal in your invoices.

Because the balance card uses real-time linear decay, it remains accurate right up to and across the period boundary — your team will always see the correct figure.