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
Next Steps
View Transactions
Audit payment history for your subscriptions
Subscription Lifecycle
Understand all subscription states and events
Implement Billing UI
Add billing components to your application
Configure Stripe
Update payment settings if needed