Stripe Integration

Connect Stripe to track revenue metrics like MRR, ARR, and subscriptions

Overview

The Stripe integration provides comprehensive revenue analytics including MRR, ARR, active subscriptions, customer count, and payment metrics.

What you’ll track:

• Monthly Recurring Revenue (MRR)
• Annual Recurring Revenue (ARR)
• Active subscriptions
• Total customers
• Revenue trends
• Failed payments

Prerequisites

Before connecting Stripe, ensure you have:

• A Stripe account with active subscriptions or payments
• Admin access to your Stripe dashboard
• A Dashtray account (any tier)

Connection Steps

1. Navigate to Integrations

   1. Log in to your Dashtray account
   2. Click Integrations in the sidebar
   3. Find Stripe in the Revenue category
   4. Click Connect
2. Authorize Stripe

   You’ll be redirected to Stripe’s OAuth authorization page.

   1. Select your Stripe account
   2. Review the requested permissions (read-only access)
   3. Click Connect

   Dashtray only requests read-only access to your Stripe data. We never have permission to modify your Stripe account.

3. Initial Data Sync

   After authorization, Dashtray will:

   • Fetch your last 90 days of data
   • Calculate MRR and ARR
   • Display metrics on your dashboard

   This usually takes 30-60 seconds.

4. Verify Connection

   Check your Overview dashboard to see:

   • Stripe MRR card
   • Revenue chart
   • Subscription count
   • Customer metrics

Available Metrics

Revenue Metrics

Metric	Description	Unit
stripe_mrr	Monthly Recurring Revenue	USD
stripe_arr	Annual Recurring Revenue	USD
stripe_revenue	Total revenue	USD

Subscription Metrics

Metric	Description	Unit
stripe_active_subscriptions	Number of active subscriptions	count
stripe_customers	Total customer count	count
stripe_failed_payments	Failed payment attempts	count

Webhook Setup (Optional)

For real-time updates, configure Stripe webhooks:

1. Get Webhook URL

   1. Go to Integrations → Stripe → Settings
   2. Copy your unique webhook URL

   https://api.dashtray.com/webhooks/stripe/{your-project-id}
   
2. Add Webhook in Stripe

   1. Go to Stripe Dashboard
   2. Click Add endpoint
   3. Paste your Dashtray webhook URL
   4. Select events to listen for:
      • customer.subscription.created
      • customer.subscription.updated
      • customer.subscription.deleted
      • invoice.payment_succeeded
      • invoice.payment_failed
   5. Click Add endpoint
3. Verify Webhook

   Test the webhook by creating a test subscription in Stripe.

   The metric should appear in Dashtray within seconds.

Troubleshooting

Connection Failed

Problem: OAuth authorization fails or times out.

Solutions:

• Ensure you’re logged into the correct Stripe account
• Check that you have admin permissions
• Try disconnecting and reconnecting
• Clear browser cache and cookies

No Data Showing

Problem: Metrics don’t appear after connection.

Solutions:

• Wait 1-2 minutes for initial sync to complete
• Click Refresh on your dashboard
• Verify you have active subscriptions in Stripe
• Check that your Stripe account is in live mode (not test mode)

Incorrect MRR Calculation

Problem: MRR doesn’t match your expectations.

Explanation:

• MRR includes only active recurring subscriptions
• One-time payments are excluded
• Trials are excluded until converted
• Canceled subscriptions are removed immediately

Webhook Not Working

Problem: Real-time updates aren’t appearing.

Solutions:

• Verify webhook URL is correct
• Check webhook signing secret matches
• Review Stripe webhook logs for errors
• Ensure selected events include subscription changes

Data Refresh

Manual Refresh

Click Refresh on your dashboard to fetch the latest data from Stripe.

Manual refresh fetches the last 7 days of data to capture recent changes.

Automatic Sync

Automatic syncing is available on Pro and Scale tiers:

• Pro tier: Every 3 hours
• Scale tier: Every 30 minutes

Webhook Updates

With webhooks configured, updates appear in real-time:

• New subscriptions: Instant
• Cancellations: Instant
• Payment events: Instant

Best Practices

1. Use Live Mode

Connect your live Stripe account, not test mode:

• Test mode data won’t reflect real revenue
• Switch to live mode in Stripe before connecting

2. Configure Webhooks

Set up webhooks for real-time updates:

• Reduces need for manual refreshes
• Provides instant notification of changes
• More accurate real-time metrics

3. Monitor Failed Payments

Track failed payment metrics to:

• Identify payment issues early
• Reduce involuntary churn
• Improve revenue retention

4. Compare Time Periods

Use time range selector to compare:

• Month-over-month growth
• Seasonal trends
• Impact of pricing changes

Security & Privacy

Data Access

Dashtray requests read-only access to:

• Subscription data
• Customer information (email, ID only)
• Payment events
• Invoice data

We never access:

• Payment methods or card details
• Bank account information
• Personally identifiable information beyond email

Credential Storage

• OAuth tokens are encrypted with AES-256-GCM
• Tokens are stored securely in our database
• You can revoke access anytime from Stripe dashboard

Data Retention

Data retention depends on your tier:

• Starter: 3 days
• Basic: 30 days
• Pro/Scale: Unlimited

Disconnecting

To disconnect Stripe:

1. Go to Integrations → Stripe
2. Click Disconnect
3. Confirm disconnection

Disconnecting will stop data syncing. Historical data will be retained according to your tier’s retention policy.

You can also revoke access from Stripe:

1. Go to Stripe Settings
2. Find Dashtray
3. Click Revoke access

Next Steps

Create Custom Dashboard

Build a revenue-focused dashboard

Set Up Alerts

Get notified of revenue changes

Connect More Integrations

Add GitHub, Vercel, or PostHog

AI Insights

Ask questions about your revenue

Support

Need help with Stripe integration?

• Email: [e-mail]
• Stripe Docs: stripe.com/docs
• Status: status.dashtray.com