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

# Subscriptions

> View and manage customer subscriptions in the moneydevkit dashboard

The subscriptions page in your moneydevkit dashboard lets you view all recurring subscriptions, track their status, and manage renewals and cancellations.

## What are Subscriptions?

Subscriptions are created when a customer completes a checkout for a product with a recurring interval. Unlike one-time purchases, subscriptions:

* Bill customers on a recurring schedule (monthly, quarterly, or yearly)
* Send automatic renewal reminder emails
* Include a grace period for missed payments
* Can be canceled by customers or merchants

## Subscriptions Dashboard

The subscriptions page in your [moneydevkit dashboard](https://moneydevkit.com/dashboard/subscriptions) displays all subscriptions with key metrics:

* **Active subscriptions** - Currently billing subscriptions
* **Past due subscriptions** - Subscriptions in the grace period awaiting payment
* **Canceled subscriptions** - Subscriptions that have ended

## Subscription Details

Each subscription record includes:

| Field                  | Description                                                 |
| ---------------------- | ----------------------------------------------------------- |
| **Subscription ID**    | Unique identifier (click to copy)                           |
| **Customer**           | Customer name and email                                     |
| **Product**            | The recurring product being billed                          |
| **Amount**             | Subscription price per period                               |
| **Currency**           | USD or SAT                                                  |
| **Status**             | Current subscription status                                 |
| **Recurring Interval** | Monthly, Quarterly, or Yearly                               |
| **Current Period**     | Start and end dates of the current billing period           |
| **Started At**         | When the subscription was created                           |
| **Canceled At**        | When cancellation was requested (if applicable)             |
| **Ends At**            | When the subscription will end (if canceling at period end) |

## Subscription Statuses

| Status     | Description                           | Customer Access            |
| ---------- | ------------------------------------- | -------------------------- |
| `active`   | Subscription is current and paid      | Full access                |
| `past_due` | Payment missed, in 3-day grace period | Full access (grace period) |
| `canceled` | Subscription has ended                | No access                  |

### Grace Period Behavior

When a subscription enters the `past_due` status:

1. The customer receives daily emails for 3 days with a renewal link
2. The subscription remains active during this period
3. If no payment is received after 3 days, the subscription auto-cancels

<Tip>
  Use `hasActiveSubscription` in your code to check if a customer should have access. This returns `true` for both `active` and implicitly covers subscriptions still in their billing period.
</Tip>

## Managing Subscriptions

### Viewing Subscriptions

1. Navigate to Subscriptions in the dashboard
2. Use filters to view by status (Active, Past Due, Canceled)
3. Click any subscription to view details

### Canceling Subscriptions

Subscriptions can be canceled in two ways:

**Cancel at period end** (default):

* Subscription remains active until the current period ends
* Customer retains access until the billing period expires
* No refund needed since they've already paid for the current period

**Cancel immediately**:

* Subscription ends immediately
* Customer loses access right away
* Consider issuing a prorated refund

<Warning>
  Immediate cancellation removes customer access instantly. Use cancel at period end for a better customer experience.
</Warning>

## Subscription Lifecycle

```
Created → Active → [Renewal payment] → Active (new period)
                 ↘
                   Past Due → [Payment within 3 days] → Active
                            ↘
                              Canceled (auto or manual)
```

See the [Subscriptions integration guide](/subscriptions) for implementation details.