Blog/Stripe Smart Retries
Payments · Recovery basics

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.

SettingSmart RetriesCustom schedule
TimingStripe uses signals like recent device activity and the time of dayYou choose each retry runs cadence and length
AttemptsAs many as you set within the window. New accounts default to up to 8 tries in 2 weeks.Up to 3 retries
Window1 week to 2 monthsDetermined 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

  1. 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.

  2. 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.

  3. Decide what happens when retries run out

    In your failed-payment settings, choose whether the subscription is canceled, marked unpaid, or left past due.

  4. 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, and revocation_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.

ToolHow it retriesNotable limits
Stripe BillingSmart Retries picks the timing, or you set a custom scheduleCustom schedules allow up to 3 retries
SquareEmails the customer an invoice to payDeclined automatic payments on recurring invoices aren't retried
ChargebeeDunning 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.
RecurlyIntelligent 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.
PaddlePaddle Retain retries Paddle Billing subscriptions at times its algorithms chooseUp to 7 retries in 30 days, where recovery is likely
BraintreeOptional retries on a schedule you setTwo retries once a subscription is past due, 1 to 10 days apart. Hard declines aren't retried.
AdyenAuto Rescue retries at times its “smart logic” picks, within a window you setAdyen has to turn it on. For cards, the window is 1 to 48 days.
MaxioRetry and dunning schedules you configure step by stepSchedules 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.

Back to all articles

Recover the revenue your processor gave up on

Connect Stripe or Square in minutes and turn on recovery when you're ready. 7-day free trial on subscription plans.

Cancel anytime