Connect Stripe

Connect your account

From Overview (or Settings → Stripe), click Connect Stripe. You're redirected to Stripe's own OAuth screen — approve the connection and you're back in churnhook.

• The connection uses Stripe Connect (Standard). You grant access from Stripe's side, and can revoke it there at any time.
• No secret key ever leaves Stripe. churnhook authenticates with its own platform credentials; your account's API keys are never stored.
• You can connect a test-mode account first and switch to live later.
• Win-back Checkout needs your connected account's public business name. Set it in the Stripe Dashboard — OAuth can't fill that field for you.

The first sync

Right after connecting, churnhook imports your customers and subscriptions in the background. You can leave the page — Overview shows progress and refreshes itself once the import finishes.

If the import stays stuck on "syncing" for a while, go to Settings → Stripe → Sync now. A stuck import is automatically marked failed and a new one starts.

Subscriptions that were already past due before you connected show up right away in To handle → Unpaid, marked at risk — even though no sequence has run for them yet. The same goes for cancels already scheduled (on Leaving) and cancellations that already happened (on Canceled). Stripe doesn't replay those past events: once your sequences are ready, the Enroll button on each list starts the journey for these customers. It's a choice you make, not something automatic.

Keeping data fresh

After the first import, Stripe webhooks keep everything in sync in real time. You can re-import on demand from Settings → Stripe → Sync now; the same section shows the status and counts of the last sync.

Disconnecting

In Settings → Stripe, the danger zone has Disconnect. Syncing and recovery stop, but data already imported is kept.