Subscription Management Dashboard

The Subscription Management Dashboard gives store administrators a centralized view of every active subscription on the tenant. It complements the existing Plans section by adding real-time visibility into individual orders created through recurring or prepaid plans.

Purpose

• Provide a single place to audit, filter, and search subscriptions without exporting data.
• Help support agents answer "Is this customer still active?" faster.
• Surface potential revenue risks (paused, cancelled, or refunded subscriptions).
• Offer quick links to detailed order and user records.

Scope & Data Source

The dashboard lists orders associated with recurring or prepaid subscription plans only.

• External plans (sales recorded via the External gateway) and subscriptions assigned manually by an administrator are excluded.
• Results are limited to orders processed through Mercado Pago or Stripe. Other gateways (PayPal, manual cash entries, etc.) are not displayed.

This focus ensures that every row represents a subscription we actively bill and reconcile through our primary payment processors.

Access Path

Dashboard → Plans → Subscriptions

A new secondary navigation item called Subscriptions appears under Plans. Selecting it loads a table that paginates results and keeps filters in the URL for easy sharing.

Table Columns

Column	Description
ID	Internal subscription identifier (clickable link to order detail)
Email	Customer email linked to user profile
Plan	Name of the plan purchased
Interval	Billing frequency (monthly, annual, or prepaid)
Status	Current state; rendered as a colored badge (Active, Paused, Cancelled, Refunded)
Start Date	Date the subscription was created
Valid To	End date if set (for prepaid plans or after cancellation)
Last Payment	Date of the most recent approved payment
Payments	Total number of approved payments received
Amount	Recurring price of the plan (uses order currency)
Next Charge	Scheduled next billing date (if calculated)
Notes	Indicates whether shipping notes exist for the order

Next Charge calculation: This field is filled only when all of the following hold true:

1. The order status is approved.
2. The underlying plan is recurring (monthly or annual).
3. Either the subscription is still within its trial period (in which case the value equals created_at + free_trial_days) or there is at least one approved payment, in which case we add one billing interval to the last payment date.

If any of these conditions are not met—paused, cancelled, or refunded orders; prepaid plans; manually-assigned or external subscriptions—the column remains blank.

The dashboard displays 15 subscriptions per page and uses cursor-based pagination for consistent performance on large datasets.

Filters & Search

Search Bar

Enter any of the following to narrow results:
• ID – exact match
• Email – partial or full match
• Plan name – partial match

Status Filter

A dropdown lets you scope the table to a specific lifecycle state:

• All (default)
• Active (approved)
• Paused
• Cancelled
• Refunded

---

For configuring plan pricing or shipping options, refer to Plans – Configuration & Management.