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 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:
- The customer receives daily emails for 3 days with a renewal link
- The subscription remains active during this period
- If no payment is received after 3 days, the subscription auto-cancels
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.
Managing Subscriptions
Viewing Subscriptions
- Navigate to Subscriptions in the dashboard
- Use filters to view by status (Active, Past Due, Canceled)
- 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
Immediate cancellation removes customer access instantly. Use cancel at period end for a better customer experience.
Subscription Lifecycle
Created → Active → [Renewal payment] → Active (new period)
↘
Past Due → [Payment within 3 days] → Active
↘
Canceled (auto or manual)
