Accessing Subscriptions
Navigate to Console > Payments > Subscriptions to view the subscriptions list. (((REPLACE_THIS_WITH_IMAGE: cloud-admin-subscriptions-list.png: Subscriptions list page showing table with user email, plan, status, and dates)))Subscriptions List
The subscriptions table displays:| Column | Description |
|---|---|
| User | End user’s email address |
| Plan | Subscription plan name from Stripe |
| Status | Current subscription status |
| Amount | Recurring charge amount and currency |
| Current Period | Billing cycle start and end dates |
| Created | When the subscription was created |
Subscription Statuses
Status Definitions
| Status | Meaning | User Access | Developer Action |
|---|---|---|---|
| active | Subscription is current and paid | ✅ Full access | None required |
| trialing | User is in free trial period | ✅ Full access | Monitor conversion |
| past_due | Payment failed, retrying | ✅ Grace period | Contact user if persistent |
| cancelled | User cancelled, access until period end | ⚠️ Until period end | Retention opportunity |
| paused | Temporarily paused | ❌ No access | Resume when ready |
| unpaid | Grace period ended, no payment | ❌ No access | Requires user action |
| incomplete | Initial payment pending | ❌ No access | Payment required |
Filtering Subscriptions
Use the filter controls to find specific subscriptions:By Status
Filter to show only subscriptions with a specific status:- All Statuses
- Active
- Trialing
- Past Due
- Cancelled
- Paused
- Unpaid
By Project
When managing multiple projects, filter subscriptions by project:- Select the project from the dropdown
- View only that project’s subscriptions
- Or select “All Projects” for a global view
By Date Range
Filter by subscription creation date:- Last 7 days
- Last 30 days
- Last 90 days
- Custom range
Subscription Details
Click on a subscription row to view detailed information:Customer Information
Customer Information
- User ID and email
- Stripe Customer ID
- Customer creation date
Subscription Details
Subscription Details
- Stripe Subscription ID
- Plan name and price
- Billing interval (monthly/yearly)
- Trial dates (if applicable)
Billing History
Billing History
- List of payments for this subscription
- Payment dates and amounts
- Success/failure status
Status Timeline
Status Timeline
- Status changes over time
- Cancellation reasons (if captured)
- Pause/resume history
Monitoring Subscription Health
Use the subscriptions view to monitor key metrics:Active Rate
Churn Indicators
Watch for warning signs:| Signal | Indicates | Action |
|---|---|---|
Rising past_due count | Payment collection issues | Review payment failure emails |
Spike in cancelled | User dissatisfaction | Review cancellation feedback |
Many incomplete | Checkout friction | Check checkout flow |
| Low trial conversion | Value proposition unclear | Improve onboarding |
Best Practices
Weekly Review
Review subscription health weekly. Address past_due subscriptions promptly.
Retention Campaigns
Contact users who cancelled with win-back offers before their access ends.
How End Users Manage Subscriptions
End users manage their subscriptions through the Customer Portal in your application:| Action | How End User Does It | What Happens |
|---|---|---|
| View Status | Dashboard subscription widget | Fetches status from Cloud API |
| Change Plan | Customer Portal → Change plan | Stripe handles proration |
| Update Payment | Customer Portal → Update payment | Stripe updates default method |
| Cancel | Customer Portal → Cancel | Access continues until period end |
| View Invoices | Customer Portal → Invoices | Downloads from Stripe |
Exporting Data
Export subscription data for analysis or reporting:- Apply desired filters
- Click Export button
- Choose format (CSV or JSON)
- Download the file
- All visible columns
- Applied filter criteria
- Export timestamp
Related Views
Transactions
View individual payment transactions for subscriptions
Statistics
See aggregated subscription metrics on your dashboard
Troubleshooting
Subscription not appearing
Subscription not appearing
- Verify webhook is correctly configured for
customer.subscription.created - Check Stripe Dashboard for webhook delivery status
- Ensure the subscription was created for the correct project
Status out of sync
Status out of sync
- Webhook may have failed delivery; check Stripe Dashboard
- Manually trigger a resend from Stripe’s webhook logs
- Subscription status updates on next webhook event
Missing user email
Missing user email
- User may have been created without email in Stripe
- Check the Stripe Customer record
- Customer email is pulled from Stripe metadata