Stripe App
Install the LostChurn app from the Stripe Marketplace to see recovery intelligence directly in your Stripe Dashboard.
The LostChurn Stripe App brings recovery intelligence directly into your Stripe Dashboard. View decline code analysis, ML retry scores, and recovery campaign status without leaving Stripe.
What You Get
Once installed, LostChurn panels appear on four pages in your Stripe Dashboard:
- Payment detail -- See the decline reason, retry score, and recovery status for any failed payment.
- Customer detail -- View churn risk, recovery history, and monthly recurring revenue for each customer.
- Subscription detail -- Identify at-risk subscriptions and see active recovery campaigns.
- Invoice detail -- Track retry outcomes and dunning status for failed invoices.
These panels update in real time as LostChurn processes events and executes recovery strategies.
Install from the Stripe Marketplace
- Visit the LostChurn app on the Stripe Marketplace.
- Click Install app.
- Review the permissions LostChurn requests:
- Payment Intents (Read) -- display recovery status and decline reasons
- Customers (Read) -- show churn risk and recovery history
- Subscriptions (Read) -- identify at-risk recurring revenue
- Invoices (Read) -- track failed payment amounts and retry outcomes
- Click Install to confirm.
- After installation, you are redirected to LostChurn to connect your account. If you already have a LostChurn account, sign in. If not, create one during this step.
The Stripe App is read-only. It displays LostChurn data inside Stripe but does not modify your Stripe data. Recovery actions (retries, dunning) are managed through your LostChurn dashboard or the separate webhook integration.
Connect Your LostChurn Account
After installing the Stripe App, you need to link it to your LostChurn workspace:
- The post-install redirect takes you to
app.lostchurn.com/onboarding?source=stripe-marketplace. - Sign in or create a LostChurn account.
- Select the workspace you want to connect.
- LostChurn verifies the connection and begins displaying recovery data in your Stripe Dashboard panels.
If you skip this step, the app panels in Stripe will show a "Connect your LostChurn account" prompt with a link to complete setup.
Webhook Configuration
The Stripe App provides in-dashboard panels but does not handle webhooks on its own. To enable full recovery (retries + dunning), you also need to connect Stripe as a payment processor:
- In your LostChurn dashboard, go to Settings > Integrations and click Connect Stripe.
- Complete the OAuth flow or provide a restricted API key.
- LostChurn automatically registers a webhook endpoint at
https://webhooks.lostchurn.com/v1/stripe.
Once webhooks are configured, the Stripe App panels show live recovery data as events flow in.
The Stripe App and the Stripe webhook integration are separate connections. Install the app for in-dashboard panels. Connect Stripe as a PSP for recovery actions. You need both for the full experience.
What Data Syncs
| Data | Direction | Description |
|---|---|---|
| Decline codes | Stripe to LostChurn | Extracted from failed payment events for analysis |
| Retry scores | LostChurn to Stripe App | ML-predicted optimal retry timing displayed in panels |
| Recovery status | LostChurn to Stripe App | Active, recovered, or churned status per payment |
| Churn risk | LostChurn to Stripe App | Customer-level risk score shown on customer detail |
| Campaign status | LostChurn to Stripe App | Active dunning campaigns shown on relevant records |
Supported Stripe Events
When the webhook integration is active, LostChurn processes these events:
| Event | What Happens |
|---|---|
invoice.payment_failed | Creates a failed payment record, triggers retry evaluation |
invoice.payment_succeeded | Marks recovery as successful, stops dunning |
invoice.payment_action_required | Sends 3D Secure authentication email to customer |
customer.subscription.deleted | Records churn event |
charge.failed | Creates failed charge record |
charge.refunded | Records refund for revenue reporting |
payment_method.updated | Triggers immediate retry of pending failures |
Test Mode
The Stripe App works in both test and live mode. Stripe test mode keys (starting with sk_test_) connect to Stripe's sandbox environment. All events and panels operate independently from live mode. You can install the app on a test account first to verify the experience before going live.
Troubleshooting
Panels show "No data available"
- Confirm you completed the post-install account connection step.
- Verify that the Stripe webhook integration is active under Settings > Integrations in your LostChurn dashboard.
- Check that webhook events are flowing by viewing Events in your LostChurn dashboard.
App does not appear in Stripe Dashboard
- Go to Settings > Installed apps in your Stripe Dashboard and confirm LostChurn is listed.
- Refresh the page. Stripe Apps load asynchronously and may take a moment to appear.
"Connect your LostChurn account" prompt persists
- Click the link in the prompt and complete the OAuth connection.
- If you already connected, try disconnecting and reconnecting from Settings > Integrations in LostChurn.
Next Steps
- Stripe webhook integration covers the full PSP connection for retries and dunning
- Recovery campaigns to configure what happens after a payment fails
- Analytics dashboard to track recovery performance