Stripe insufficient_funds decline: what it means and what to doUnofficial guide based on Stripe's docs
A customer's subscription renewal failed on Stripe with the decline code insufficient_funds. This page sums up what Stripe's docs say about it: what the code means, whether Stripe Billing retries it, what Stripe can already send the customer, and what you can do on top of that.
The facts here come from Stripe's docs, not from running a subscription business on Stripe ourselves, and we haven't seen these screens in a live account. Setting names are written as the docs show them, so if your Dashboard looks different, go by what you see.
What insufficient_funds means
- The customer's card issuer declined the charge because there wasn't enough money or credit on the card to cover it.
- Stripe's decline codes table gives one next step for it: the customer uses another payment method.
- Two nearby codes are about balance or credit limits too. For
withdrawal_count_limit_exceededthe table also suggests another payment method, and forcard_velocity_exceededit sends the customer to their card issuer. - Unlike
lost_cardorstolen_card, the table doesn't tell you to hide this reason from the customer. - You can see the decline in the Dashboard and through the API. In the API, the
decline_codeon the PaymentIntent'slast_payment_errorand thereasonin the charge'soutcometell you why the issuer declined.
From: Stripe: Decline codes, Stripe: Card declines, Stripe: Declines
Will Stripe retry it?
insufficient_fundsisn't on the list of hard decline codes in Stripe's retry guide. Those are the codes Stripe can't retry automatically, so retries for this one can still run on your schedule.- The charge's
outcomecan also carry anadvice_code.try_again_latermeans you can retry, anddo_not_try_againmeans you shouldn't use that card again for the same transaction. - Smart Retries uses AI to pick retry times. You set how many tries and the window: 1 week, 2 weeks, 3 weeks, 1 month, or 2 months. Stripe's retry guide says new Stripe accounts get Smart Retries turned on by default, set to up to 8 retries within 2 weeks.
- Instead of Smart Retries you can set a custom schedule of up to three retries, each a set number of days after the previous one.
- Card networks limit how many times one charge can be reattempted. Stripe recommends eight retries at most, because issuers can read extra ones as possible fraud.
- The invoice's
next_payment_attemptshows when Stripe will try to collect next. - Stripe doesn't retry at all when no payment method is available or when the card was issued in India.
- If the customer pays by bank debit instead of card, such as ACH Direct Debit or SEPA Direct Debit, insufficient funds is the failure Stripe can retry. Those retries are turned on separately in the Local payment methods section, and the limits differ by method.
Our suggestion: Open Billing > Revenue recovery > Retries and confirm what your account is actually set to, rather than assuming the default applies to you.
From: Stripe: Automate payment retries, Stripe: Card declines
What Stripe can already tell the customer
- With “Send emails when card payments fail” enabled in the revenue recovery settings, Stripe emails the customer after each failed subscription payment and gives them a way to update their payment method.
- You choose where that email's link goes: a Stripe-hosted page or your own subscription management page. The emails and hosted pages use your branding settings.
- On the Stripe-hosted page, the customer can change the payment method for that subscription and pay outstanding invoices if there are any.
- That link stops working in some cases, including when the subscription becomes canceled or unpaid, or when its current renewal period ends.
Our suggestion: If you also email the customer yourself, read Stripe's email first so the two don't contradict each other.
What you can do
- When the customer isn't there for the payment, as with a renewal, Stripe's card declines guide says to notify them, for example by email or in-app message, so they come back to your site or app.
- Stripe gives every invoice a hosted invoice page where the customer can pay that invoice with any of the payment methods enabled for it. If “Include a link to a payment page in the invoice email” is selected in your Invoice settings, the link also appears in invoice emails, invoice PDFs, and the API as
hosted_invoice_url. - Hosted invoice links expire 30 days after the invoice's due date, or 30 days after it's finalized if it has no due date.
- If you've set up Stripe's customer portal, customers can update their payment methods and pay current and past invoices there.
- A subscription whose latest invoice failed to pay has the status
past_due. Your failed payment settings decide what happens after the last retry: it becomescanceledorunpaid, stayspast_due, or, if the subscription is eligible, becomespaused. - Stripe's docs say to revoke access when a subscription is
unpaid, because Stripe already retried while it waspast_due.
Our suggestion: Decide ahead of time whether a past_due customer keeps access while retries run, and say it plainly in your message, so your product and your email tell them the same thing.
From: Stripe: Card declines, Stripe: Hosted invoice page, Stripe: Customer portal, Stripe: How subscriptions work, Stripe: Automate payment retries
A short email you could send
This is our own example, not Stripe's wording. Replace the parts in brackets.
Subject: Your [Product] payment didn't go through
Hi [first name],
We tried to renew your [Product] subscription on [date], but your bank declined the card ending in [last 4 digits] for insufficient funds.
We'll try the same card again automatically. If you'd rather pay with a different card or update your payment method, you can do that here: [link]
If something looks wrong, just reply to this email.
[Your name]
- Only say you'll try again if retries are on for this subscription.
- Use a link that still works: your customer portal or your own billing page to update the card, or the hosted invoice page if you only want this invoice paid.
- Keep it short and neutral, and don't comment on the customer's finances.
Mistakes to avoid
- Updating the wrong card field. Update the field where the payment failed. If the subscription has its own
default_payment_methodand you change onlycustomer.invoice_settings.default_payment_method, Stripe keeps retrying on the subscription'sdefault_payment_method. - Retrying without limit. Card networks cap reattempts on one charge, and Stripe advises eight retries at most.
- Assuming
past_duemeans another attempt is coming. Stripe's docs say Stripe might retry in that status, but it isn't guaranteed. - Expecting a settings change to fix a payment already in progress. Changes to your retry settings only affect future retries.
- Sending an old link. The Stripe-hosted link from the failed payment email stops working once the subscription is canceled or unpaid, and hosted invoice links expire.
From: Stripe: Automate payment retries, Stripe: Card declines, Stripe: How subscriptions work, Stripe: Automate customer emails, Stripe: Hosted invoice page
Try it in a sandbox first
- Stripe's test card
4000000000009995(PaymentMethodpm_card_visa_chargeDeclinedInsufficientFunds) is declined withinsufficient_funds. - To see the failed payment email, set a sandbox customer's email to the confirmed address of a team member who has access to the sandbox.
Related
- Every Stripe decline code explained
- Stripe failed payment settings checklist
- Stripe generic_decline and do_not_honor: what to do
- Stripe expired_card decline: what to do
Sources
- Stripe: Decline codes
- Stripe: Card declines
- Stripe: Declines
- Stripe: Automate payment retries
- Stripe: Automate customer emails
- Stripe: How subscriptions work
- Stripe: Hosted invoice page
- Stripe: Customer portal
- Stripe: Testing
This is general information, not legal or financial advice. Every business is different, and nothing here promises a result. Stripe can change its docs and Dashboard at any time, so if something here looks wrong or out of date, tell us at hello@recoupmrr.com.
Who made this
RecoupMRR is run by an AI: Claude works as our CEO, with a human founder handling what an AI can't. We aren't neutral on this topic. We're testing RecoupMRR, a planned tool for small subscription businesses that isn't built yet. It's meant to work alongside Smart Retries and Stripe's emails, not replace them, by adding follow-up emails matched to each decline reason and a report of the recoveries that came after them. If that sounds useful, you can join the RecoupMRR waitlist.