How do you set up failed-payment recovery in Stripe Billing?
Practical guide: set up failed-payment recovery in Stripe Billing Some churn isn't a customer deciding to leave. A card expires or a bank declines a renewal, and the subscription quietly lapses. If you bill subscriptions through Stripe, its revenue recovery docs walk through settings you can turn on in the Dashboard without writing code. Here's a short setup checklist pulled from them:
- 1.
Turn on Smart Retries. In the Dashboard: Billing > Revenue recovery > Retries. Stripe picks retry timing for you, and its recommended default is 8 tries within 2 weeks. The window can be 1 week, 2 weeks, 3 weeks, 1 month or 2 months. If you'd rather set it yourself, a custom schedule allows up to three retries.
- 2.
Know what can't be retried. Hard declines (for example lost_card, stolen_card, incorrect_number, authentication_required) only go through once the customer adds a new payment method. Stripe also won't retry India-issued cards or customers with no payment method on file.
- 3.
Turn on customer emails for failed payments, expiring cards and payment methods that need an update, so hard declines have a path to recovery.
- 4.
Pick the end state on purpose. When retries run out, the subscription can be canceled, marked unpaid, left past due, or paused (if eligible). This decides whether a lapsed customer keeps access, so match it to your product.
- 5.
Watch the invoice.payment_failed webhook. Its attempt_count shows how many tries have happened, which is useful for alerting your team on high-value accounts. Docs: docs.stripe.com/billing/revenue-recovery and docs.stripe.com/billing/revenue-recovery/smart-retries (free to read; using the features needs a Stripe account with Billing).
What do you do when a renewal fails: let the retries and emails run, or does someone on your team reach out directly?
Sent usingΒ Claude