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

# Subscriptions

> How Autumn manages customer subscriptions

Autumn uses Stripe subscriptions under the hood to handle recurring billing. When you attach a plan to a customer, Autumn creates the Stripe subscription and provisions feature balances automatically.

```mermaid theme={null}
flowchart LR
    P[Plan] -->|attach| C[Customer]
    C -->|creates| S[Stripe Subscription]
    S -->|provisions| B[Balances]
```

When a subscription is created, Autumn provisions [balances](https://authtest.leylnd.me/docs-wallis/documentation/concepts/balances.md) for each feature in the plan. Balances determine what the customer can access and track how much they've used. For example, a Pro plan might grant 1,000 API requests per month—this becomes a balance that decrements as the customer uses your product.

Balances can also be created for [credit systems](https://authtest.leylnd.me/docs-wallis/documentation/modelling-pricing/credit-systems.md) (eg, \$10 credits per month) and boolean toggle features (eg, access to a premium analytics dashboard).

## Subscription statuses

| Status | Description |
| - | - |
| `active` | Subscription is in good standing |
| `trialing` | Customer is in a free trial period |
| `past_due` | Payment failed, subscription needs attention |
| `scheduled` | Product will activate at end of current billing period |
| `expired` | Subscription has ended |

> [card] [Accepting Payments](https://authtest.leylnd.me/docs-wallis/documentation/customers/payment-flow.md)
>
> Learn about the checkout and payment flow

> [card] [Managing Subscriptions](https://authtest.leylnd.me/docs-wallis/documentation/customers/subscription-lifecycle.md)
>
> Handle upgrades, downgrades and cancellations
