What You Can Do
With the Stripe integration, you can:- Track MRR & ARR - Monitor monthly and annual recurring revenue with optional trial inclusion
- Count customers - Track total, active, new, or churned customer counts over time
- Monitor subscriptions - Count subscriptions by status (active, trialing, past due, canceled)
- Measure revenue - Track total revenue, net revenue, refunds, and processing fees
- Calculate ARPU - Measure average revenue per user over time
- Analyze churn - Track customer churn rate, revenue churn rate, and churned MRR
- Monitor NRR - Track net revenue retention to measure expansion vs contraction
- Set up alerts - Get notified when metrics cross thresholds or change significantly
- Test mode support - Use test API keys to track metrics from test data during development
Connecting Stripe
Navigate to Settings
Click your profile menu in the top-right corner and select Settings, then go to Integrations
Enter Credentials
In the configuration dialog, enter:
- Integration Name - A name to identify this connection (e.g., “Production Stripe”)
- Secret API Key - Your Stripe secret key (starts with
sk_live_orsk_test_)
Finding Your API Key
- Log in to your Stripe Dashboard
- Go to Developers > API keys
- Copy your Secret key (click to reveal if hidden)
Test Mode vs Live Mode
Stripe provides separate API keys for test and live mode:| Key Prefix | Mode | Use Case |
|---|---|---|
sk_test_ | Test | Development and testing with simulated data |
sk_live_ | Live | Production with real customer and payment data |
When using a test mode key, metrics will only reflect test data. Use live mode keys to track real production metrics.
Linking Metrics to Goals
Once connected, you can link Stripe metrics to your product goals for automatic progress tracking.
Metric Types
Stripe supports eight metric types for tracking different aspects of your subscription business:MRR (Monthly Recurring Revenue)
Track your monthly recurring revenue from active subscriptions.| Setting | Description |
|---|---|
| Include Trials | Toggle to include or exclude trialing subscriptions |
- Track overall business health
- Monitor revenue growth month-over-month
- Set revenue targets for product launches
ARR (Annual Recurring Revenue)
Track your annualized recurring revenue (MRR × 12).| Setting | Description |
|---|---|
| Include Trials | Toggle to include or exclude trialing subscriptions |
- Report annual revenue projections
- Compare against annual business goals
- Track year-over-year growth
Customer Count
Count customers based on their status over a time period.| Setting | Options |
|---|---|
| Customer Type | All Customers, Active Customers, New Customers, Churned Customers |
| Time Range | Last Day, Last Week, Last Month, Last Quarter, Last Year |
- Track total customer growth
- Monitor new customer acquisition
- Identify churned customer trends
Subscription Count
Count subscriptions by their current status.| Setting | Options |
|---|---|
| Subscription Status | All, Active, Trialing, Past Due, Canceled, Incomplete |
- Monitor active subscription count
- Track trial conversion pipeline
- Identify at-risk subscriptions (past due)
Revenue
Track various revenue metrics over time.| Setting | Options |
|---|---|
| Revenue Metric | Total Revenue, Net Revenue, Refunds, Fees |
| Time Range | Last Day, Last Week, Last Month, Last Quarter, Last Year |
- Track total collected revenue
- Monitor net revenue after refunds
- Analyze refund trends
- Track Stripe processing fees
ARPU (Average Revenue Per User)
Calculate the average revenue generated per customer.| Setting | Options |
|---|---|
| Time Range | Last Month, Last Quarter, Last Year |
ARPU is calculated over monthly periods minimum to ensure meaningful averages. Daily and weekly time ranges are not available.
- Measure monetization efficiency
- Track pricing strategy impact
- Compare customer segments
Churn
Track customer or revenue churn metrics.| Setting | Options |
|---|---|
| Churn Metric | Customer Churn Rate, Revenue Churn Rate, Churned MRR |
| Time Range | Last Month, Last Quarter, Last Year |
| Metric | Description |
|---|---|
| Customer Churn Rate | Percentage of customers lost in the period |
| Revenue Churn Rate | Percentage of revenue lost in the period |
| Churned MRR | Absolute MRR lost from cancellations |
- Monitor customer retention health
- Identify revenue leakage
- Set churn reduction targets
NRR (Net Revenue Retention)
Track net revenue retention to measure expansion vs contraction.| Setting | Options |
|---|---|
| Time Range | Last Month, Last Quarter, Last Year |
- Upgrades and expansions (+)
- Downgrades (-)
- Churned revenue (-)
- Measure upsell/expansion effectiveness
- Track customer value growth over time
- Benchmark against industry standards
Refresh Intervals
Choose how often Kasava fetches new data from Stripe:| Interval | Description |
|---|---|
| Hourly | Updates every hour - best for real-time dashboards |
| Daily | Updates once per day - best for most goals |
| Weekly | Updates once per week - best for long-term trends |
Setting Up Alerts
After linking a metric to a goal, you can configure alerts to be notified when values change:Threshold Alerts
Get notified when a metric crosses a specific value:- Threshold - The value that triggers the alert (e.g., MRR drops below $10,000)
- Direction - Alert when the metric goes above or below the threshold
Change Alerts
Get notified when a metric changes by a certain percentage:- Percentage - The change percentage that triggers the alert (e.g., 10% churn increase)
- Direction - Alert on increase, decrease, or any change
Testing Your Connection
After configuring a metric query, always click Test Query before saving. This will:- Verify your API credentials are valid
- Execute the query against Stripe’s API
- Show the current metric value
- Confirm the configuration is correct
Managing Integrations
View Integration Status
Navigate to Settings > Integrations to see all connected Stripe integrations and their status.Create Integration Metrics
You can create reusable metrics at the integration level that can be linked to multiple goals:Go to Integration Settings
Navigate to Settings > Integrations and click Manage on your Stripe integration
Disconnect Integration
Disconnecting will stop all metric syncing for goals linked to this integration. Historical data will be preserved, but no new data will be fetched.
Troubleshooting
Test query fails with 'Invalid API Key'
Test query fails with 'Invalid API Key'
Verify your secret key starts with
sk_live_ or sk_test_. Restricted keys or publishable keys (pk_) won’t work. Check that the key hasn’t been rolled or deleted in Stripe.MRR shows $0 but I have active subscriptions
MRR shows $0 but I have active subscriptions
Ensure you have subscriptions with recurring prices (not one-time payments). Check that the subscriptions are in an active state and not trialing (unless you enabled “Include Trials”).
Metrics not updating
Metrics not updating
Check the sync status in the goal’s metric section. If it shows an error, try disconnecting and reconnecting the integration. Ensure your API key hasn’t been rolled.
Churn rate seems too high
Churn rate seems too high
Verify the time range matches your expectations. Short time ranges can show higher churn rates. Also check if you’re measuring customer churn vs revenue churn, which can differ significantly.
Test mode key warning
Test mode key warning
If you see a warning about test mode, you’re using an
sk_test_ key. This is fine for development, but switch to an sk_live_ key to track real production data.Customer count doesn't match Stripe dashboard
Customer count doesn't match Stripe dashboard
Kasava counts customers with the specific status you selected. The Stripe dashboard may show different views or include deleted customers. Ensure your filter settings match.