Documentation

How DunningBear works

DunningBear is a Stripe app that tracks why your customers cancel, analyzes their feedback with AI, and delivers weekly insight reports — all inside your Stripe Dashboard.

On this page

  1. Getting started
  2. Dashboard
  3. At-risk cancellations
  4. MRR calculation
  5. Filtering and sorting
  6. Customer detail view
  7. AI insights
  8. Weekly email digest
  9. Settings

Getting started

Install DunningBear from the Stripe App Marketplace. No external accounts, API keys, or configuration needed — it works immediately inside your Stripe Dashboard.

On install, DunningBear automatically imports your existing cancellation history from Stripe. Depending on your data volume, this can take anywhere from a few seconds to a couple of minutes. You'll see an "Importing data" banner while it runs.

Once the import completes, your cancellation dashboard is ready. Going forward, every new cancellation is recorded in real time via webhooks.

Dashboard

The dashboard is your main view. It lives in the Stripe Dashboard sidebar and shows two sections: At Risk (subscriptions scheduled to cancel) and Churned (completed cancellations).

The Churned section displays three headline metrics:

  • Total number of cancellations in the selected period
  • Total MRR lost
  • Top cancellation reason

Below the metrics is a reason breakdown — an accordion that lists each cancellation reason with its count, MRR lost, and percentage of all cancellations. Expanding a reason reveals the most recent cancellations with that reason, including customer name, date, and any comment they left.

At-risk cancellations

When a customer schedules a cancellation (Stripe's "cancel at period end" behavior), DunningBear shows it in the At Risk section at the top of the dashboard. These are subscriptions you might still save.

Each at-risk entry shows: the customer name or email, their scheduled cancel date, the cancellation reason (if provided), their plan name, and the monthly MRR at stake.

At-risk cancellations are sorted by cancel date (soonest first) so the most urgent cases are always at the top. If the customer reactivates their subscription before it ends, the record is automatically removed.

MRR calculation

DunningBear normalizes all subscription amounts to monthly recurring revenue (MRR):

  • Monthly subscriptions — used as-is
  • Annual subscriptions — divided by 12
  • Weekly subscriptions — multiplied by 52, divided by 12
  • Daily subscriptions — multiplied by 365, divided by 12

Trial cancellations are always recorded with $0 MRR lost, since no revenue was generated.

Subscriptions that were already delinquent at the time of cancellation (i.e., the customer's latest invoice was unpaid) are also recorded with $0 MRR lost, since the revenue was effectively lost when payment failed, not when the subscription was formally cancelled.

Filtering and sorting

The Churned section supports two filters:

  • Time period — Last 7 days, Last 30 days (default), Last 90 days, or All time
  • Plan — Filter by product name, grouped into Monthly, Annual, and Other billing intervals

The reason breakdown can be sorted by cancellation count or by MRR lost. This is configured in Settings and applies globally.

Customer detail view

When you view a customer in Stripe, DunningBear shows that customer's cancellation history in the sidebar. Each entry includes the plan name, cancellation reason, cancel date, MRR lost, and any comment the customer left. This gives you context on a customer's churn history without leaving the Stripe Dashboard.

AI insights

Pro

DunningBear uses AI to analyze your cancellations and generate a short summary describing the dominant churn patterns — which reasons are driving cancellations and where MRR impact concentrates.

The AI reads cancellation reasons, plan names, MRR values, and customer comments across the selected time period. It produces a 1–2 sentence executive summary that surfaces themes you might miss when reviewing cancellations individually.

Insights are cached and only regenerated when the underlying set of cancellations changes (e.g., a new cancellation comes in). The same summary is reused in the weekly email digest.

Weekly email digest

Pro

Every Monday, DunningBear sends a digest email covering the previous week. It includes:

  • Total cancellations and MRR lost for the week
  • Percentage change compared to the prior week
  • Reason breakdown table sorted by count
  • AI-generated summary of churn patterns

To receive the digest, enable it in Settings and provide a contact email. The digest is only sent if there are new cancellations — you won't receive empty emails.

Settings

Access Settings from the app menu inside the Stripe Dashboard. Available options:

  • Contact email — used for the weekly digest and product updates
  • Timezone — controls how dates are displayed throughout the app
  • Sort cancellation reasons by — choose between cancellation count or MRR lost
  • Hide trial cancellations — excludes trial cancellations from all counts and breakdowns (enabled by default)
  • Weekly email digest — toggle the Monday digest on or off (Pro only)