Stripe Integration

Setup

Stripe connects via Stripe Connect OAuth, initiated from the project's Revenue layer settings:

1. Install the Revenue layer on the project.
2. In layer settings, click Connect Stripe.
3. You're redirected to Stripe's OAuth flow, where you authorize the Layers platform to read subscription data from your Stripe account.
4. On callback, Layers stores the connected-account reference as a stripe_connect_accounts row linked to the project.

Webhook setup

Layers exposes POST /api/webhooks/stripe-revenue and verifies requests using Stripe's standard signature scheme. Subscription and charge events are stored in revenue events, keyed by event.account to route to the correct connected account.

The webhook endpoint is registered once at the Layers platform level and routes events across all connected accounts.

What gets synced

An hourly Stripe sync runs per connected account, pulling subscription state and writing into Layers' metrics tables:

• MRR, ARR, active subscribers, active trials.
• Churn rate, LTV.
• 7-day and 30-day revenue and new-subscriber totals.

Multi-account

Stripe Connect supports multiple connected accounts per Layers project (each creates its own stripe_connect_accounts row). Filter the dashboard by account in the top-nav picker.

Disconnect

From the layer settings, click Disconnect. The connection is revoked on Layers' side. Historical metrics already written to Layers remain visible.