← Back to Documentation

Stripe Integration

Connect Stripe to automatically track MRR, ARR, churn, and customer metrics.

Overview

The Stripe integration is the core of Beacon's revenue analytics. It automatically syncs your subscription data, customer information, and payment history to provide real-time insights into your SaaS metrics.

Connecting Stripe

Follow these steps to connect your Stripe account:

  1. 1In your Beacon dashboard, navigate to Settings → Integrations
  2. 2Click "Connect Stripe"
  3. 3You'll be redirected to Stripe's secure authorization page
  4. 4Select the Stripe account you want to connect
  5. 5Click "Connect" to authorize Beacon
  6. 6You'll be redirected back to Beacon, where the initial data sync will begin

What Data is Synced?

Beacon syncs the following data from your Stripe account:

Data TypeUsed For
CustomersCustomer list, segmentation, health scores
SubscriptionsMRR/ARR calculations, churn tracking
InvoicesRevenue recognition, payment history
Products & PricesPlan analysis, pricing trends
Payment MethodsMetadata only (type, last 4 digits)

Data Privacy & Security

Beacon uses Stripe's OAuth 2.0 protocol for secure authentication. We follow these security practices:

Security Practices
  • ✓We never access or store full credit card numbers
  • ✓All data is encrypted in transit and at rest
  • ✓We only request the minimum permissions needed
  • ✓You can disconnect Stripe at any time from Settings

Initial Sync

When you first connect Stripe, Beacon will sync:

  • •All active and canceled subscriptions
  • •Customer data for the last 12 months
  • •Invoice history for active customers
Sync Time

Initial sync typically takes 1-5 minutes depending on your data volume. You can use Beacon while the sync completes.

Ongoing Syncing

After the initial sync, Beacon stays up-to-date in two ways:

1. Webhooks (Real-time)

Beacon automatically sets up Stripe webhooks for instant updates when:

  • •A customer subscribes or cancels
  • •An invoice is paid or fails
  • •A subscription changes plan
  • •Customer information is updated

2. Daily Background Sync

Every 24 hours, Beacon performs a full sync to ensure data accuracy and catch any events that may have been missed.

Troubleshooting

Metrics Not Updating

If your metrics aren't updating:

  1. 1Check Settings → Integrations to ensure Stripe is still connected
  2. 2Verify your Stripe account has active subscriptions
  3. 3Try disconnecting and reconnecting Stripe
  4. 4Contact support if issues persist

Missing Customers

Beacon only syncs customers who have (or had) active subscriptions. One-time payment customers won't appear in your metrics.

Disconnecting Stripe

To disconnect Stripe:

  1. 1Go to Settings → Integrations
  2. 2Click "Disconnect" next to Stripe
  3. 3Confirm disconnection
Note

Your historical data in Beacon will be preserved, but new updates won't be synced until you reconnect.

Need Help?

If you encounter issues connecting Stripe: