Documentation

Get ChurnWhisper running in 5 minutes.

1

Create an account

Sign up at churnwhisper.com and create your organization.

2

Connect Stripe

In your dashboard, click "Connect Stripe" to authorize ChurnWhisper to manage subscriptions on your behalf via Stripe Connect.

3

Add the widget

Add this snippet to your app, right before the closing </body> tag:

<script
  src="https://churnwhisper.com/widget.js"
  data-key="YOUR_API_KEY"
  async
></script>
4

Trigger the cancel flow

When a user clicks your cancel button, call the ChurnWhisper API:

// When user clicks "Cancel Subscription"
window.ChurnWhisper.open({
  customerId: "cus_xxx",      // Stripe customer ID
  subscriptionId: "sub_xxx",  // Stripe subscription ID
  revenue: 49,                // Monthly revenue (for analytics)
});
5

Customize & go live

Head to your dashboard Settings to customize the widget appearance, configure offers (discounts, pauses, downgrades), and go live. That's it!

API Reference

POST/api/widget/init

Initialize the widget. Pass your API key. Returns flow configuration.

POST/api/widget/event

Log widget events (opened, reason_selected, offer_shown, saved, churned).