Stripe Smart Retries: How it works and what it can't recover
Smart Retries is Stripe's automatic retry feature for failed subscription and invoice payments. Instead of trying the card again on a fixed schedule, Stripe uses machine learning to pick the moments a retry is most likely to succeed. Learn more about how it works, which settings to choose, and which failed payments it can't recover.
Smart Retries
Smart Retries is included in Stripe Billing. Smart Retries kicks in when a payment fails due to a soft decline. It schedules more charge attempts, and chooses the most appropriate retry times. As Stripe's docs put it, it "chooses the best times to retry failed payment attempts to increase the chance of successfully paying an invoice."
There's no separate fee for it. Stripe lists Smart Retries as included on its Billing pricing page, and its Invoicing pricing page lists smart retries as included for one-off invoices too.
How Stripe decides when to retry
A fixed schedule tries the card again after a set number of days. It times each attempt using signals that change over time. Stripe's docs give two examples: how many different devices have presented the same payment method within a recent number of hours, and the time of day a payment is most likely to go through. Debit card payments in some countries, for instance, may succeed slightly more often at 12:01 AM local time.
In a January 2024 engineering post, Stripe said the model is trained on billions of data points from across its network, using more than 500 attributes. Stripe's Billing features page says Smart Retries has helped businesses recover 57% of recurring payments that originally failed, on average. Stripe doesn't publish how that figure is calculated, so treat it as a rough benchmark rather than a prediction for your account.
Retry settings
You control two things: cadence, and sequence length. The window can be 1 week, 2 weeks, 3 weeks, 1 month, or 2 months. For new accounts, Stripe's default is up to 8 tries within 2 weeks.
If you'd rather set the timing yourself, you can turn Smart Retries off and use a custom schedule instead. A custom schedule allows up to three retries, each a set number of days after the previous attempt.
Stripe Billing also includes up to three automations, which can apply a different retry policy to different groups of customers. Depending on the trigger, you can target them by invoice amount, product, subscription interval, or metadata. When an automation runs, it overrides your general retry settings for that payment.
Payment method
Each retry charges the first payment method Stripe finds, in this order: the subscription's default payment method, the subscription's default source, the customer's default payment method for invoices, then the customer's next payment method in line. This matters when a customer updates their card. If the subscription has its own default payment method and only the customer's default gets updated, retries keep charging the old card.
Smart Retries vs a fixed retry schedule
Short answer: Stripe says smart timing recovers more. Stripe's docs say Smart Retries are “more effective than scheduled retries,” and its SaaS solutions page says businesses using smart retries “recover 14% more revenue than those retrying failed payments on a set schedule.” Stripe doesn't publish how that's measured, and the figure has changed over time, so treat it as a direction rather than a guarantee.
| Setting | Smart Retries | Custom schedule |
|---|---|---|
| Timing | Stripe uses signals like recent device activity and the time of day | You choose each retry runs cadence and length |
| Attempts | As many as you set within the window. New accounts default to up to 8 tries in 2 weeks. | Up to 3 retries |
| Window | 1 week to 2 months | Determined by retry days |
A fixed schedule still makes sense when timing matters more than volume, for example when most of your customers get paid on the same days and you want attempts to land then. Either way, neither option can fix hard declines. The customer has to add a new payment method for those.
Configuring Smart Retries
-
Open your retry settings
In the Stripe Dashboard, go to Billing > Revenue recovery > Retries for subscriptions. For one-off invoices, the retry settings are under Settings > Billing > Invoices, in the advanced invoicing features section. Stripe renames Dashboard menus from time to time, so the labels on your account may differ slightly.
-
Choose Smart Retries or a custom schedule
Set the number of retries and the maximum window. Unless you have a specific reason to change it, start with Stripe's default of up to 8 tries within 2 weeks.
-
Decide what happens when retries run out
In your failed-payment settings, choose whether the subscription is canceled, marked unpaid, or left past due.
-
Enable failed-payment emails
When this setting is enabled, Stripe emails the customer after each failed payment with a link to update their payment method. Stripe can also email customers a month before their card expires, which prevents some failures entirely.
What happens when retries run out
Once the last retry fails, Stripe makes no more attempts on that invoice. The subscription then moves to one of the following outcomes:
- Cancel the subscription. Its status becomes canceled, and Stripe turns off automatic collection on its unpaid invoices. A canceled subscription can't be restarted, so winning the customer back means starting a new subscription.
- Mark it unpaid. New invoices are created as drafts, but Stripe makes no payment attempts. Stripe suggests revoking the customer's access while the subscription is in this state.
- Leave it past due. The subscription stays past due, and new invoices keep being created and charged under your retry settings.
None of these outcomes recovers the failed transaction. A third-party tool is required past this point.
What Smart Retries can't recover
Retries work for soft declines, like a card that's short on funds today and fine the next week. Stripe doesn't run a retry at all when the following issues occur.
- The issuer returns a hard decline. Stripe lists nine decline codes it can't retry automatically, including
lost_card,stolen_card,pickup_card,incorrect_number, andrevocation_of_authorization. - The payment needs authentication. A payment that failed because the customer didn't complete 3D Secure is treated as waiting for authentication, not as failed, so your retry settings don't apply. Stripe can send the customer a link to confirm the payment instead.
Expired cards are a hard decline. Stripe's automatic card updater can fill in a reissued card's new details when the issuer takes part in the card networks' update programs. That's common for US cards but not guaranteed, and Stripe says you can't tell in advance which cards are covered.
Bank debits are opt-in. According to Stripe's retry docs, retries for local payment methods like ACH Direct Debit and SEPA Direct Debit are off by default. You can turn them on for each method, but only insufficient-funds failures are retried, and the limits are tight: up to 2 retries within 40 days for ACH Direct Debit and 2 within 30 days for SEPA.
Failed payment retry tools
Most billing platforms retry failed recurring payments on their own. They differ in how the timing is set, and how many attempts they make. Here's a look into various recovery tools, based on each vendor's own documentation as of October 2026. Plans and limits change, so check the linked docs before relying on a detail. Our failed payment recovery tools comparison covers add-on tools that work alongside these.
| Tool | How it retries | Notable limits |
|---|---|---|
| Stripe Billing | Smart Retries picks the timing, or you set a custom schedule | Custom schedules allow up to 3 retries |
| Square | Emails the customer an invoice to pay | Declined automatic payments on recurring invoices aren't retried |
| Chargebee | Dunning in Smart mode, which times retries by error type, or Custom mode, where you set the days. Revive adds machine-learning retries. | Smart mode allows up to 12 retries and is only available on some of their plans. Custom mode allows up to 5. |
| Recurly | Intelligent Retries, which uses machine learning. Static retries, which follow Recurly's sequence rules. | Intelligent Retries isn't available on the Starter or Pro plans. Both stop after 20 attempts or 60 days. |
| Paddle | Paddle Retain retries Paddle Billing subscriptions at times its algorithms choose | Up to 7 retries in 30 days, where recovery is likely |
| Braintree | Optional retries on a schedule you set | Two retries once a subscription is past due, 1 to 10 days apart. Hard declines aren't retried. |
| Adyen | Auto Rescue retries at times its “smart logic” picks, within a window you set | Adyen has to turn it on. For cards, the window is 1 to 48 days. |
| Maxio | Retry and dunning schedules you configure step by step | Schedules can run up to 365 days and 30 steps |
Smart Retries FAQ
Does Smart Retries cost extra?
No. It's included with Stripe Billing, with no separate fee.
How many times does Stripe retry a failed payment?
As many times as you set, within a window of 1 week to 2 months. New accounts default to up to 8 tries within 2 weeks. If you use a custom schedule instead, you can set up to three retries.
Does Smart Retries work on one-off payments?
It works on one-off invoices that charge the customer automatically, as long as auto-advance is on and you've turned on retries for one-off invoices. Stripe's Smart Retries documentation covers invoices only, not charges made outside of an invoice.
How can I tell if Stripe is still retrying a payment?
Each failed attempt sends an invoice.payment_failed webhook, and its attempt_count shows how many attempts have been made. The invoice's next_payment_attempt field shows when the next retry is scheduled. If you use automations, it's set in invoice.updated events, not invoice.payment_failed. After a hard decline, scheduled retries don't run until there's a new payment method.
Should I use Smart Retries or a custom schedule?
For most businesses, Smart Retries with Stripe's default settings is the simpler choice, and it can make more attempts than a custom schedule. A custom schedule makes sense when you have a specific reason to control the timing, such as matching when most of your customers get paid.
What are intelligent retries?
It's Recurly's name for its machine-learning retry timing, the counterpart to Stripe's Smart Retries. Recurly's docs say Intelligent Retries picks the best time to retry a declined recurring card payment, and that it isn't included in Recurly's Starter or Pro plans.
Recoura's role
Smart Retries handles soft declines well, and there's no reason to replace it. Where it falls short are hard declines, reissued cards the updater didn't catch, and subscriptions that ended up canceled or unpaid when the retries ran out.
That's the gap Recoura fills. It connects to your Stripe account and steps in only after Smart Retries has finished. It flags what's still unpaid, checks it against your live Stripe data to confirm it's still owed, and then sends the customer a one-click invoice to pay. The invoices can be sent automatically on a schedule you set or by hand for the accounts that deserve a personal touch. Also, our in-app banners catch a customer as soon as their payment method fails. See how the two recovery modes work, or work out what failed payments are costing you first.