> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useautumn.com/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](/documentation/concepts/balances) 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](/documentation/modelling-pricing/credit-systems) (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                                 |

<CardGroup cols={2}>
  <Card title="Accepting Payments" icon="credit-card" href="/documentation/customers/payment-flow">
    Learn about the checkout and payment flow
  </Card>

  <Card title="Managing Subscriptions" icon="sliders" href="/documentation/customers/subscription-lifecycle">
    Handle upgrades, downgrades and cancellations
  </Card>
</CardGroup>