Stripe expired_card decline: what it means and what to doUnofficial guide based on Stripe's docs

A customer's subscription renewal failed on Stripe because their card had expired, and you see expired_card. This page sums up what Stripe's docs say about it: what the code means and where it shows up, what Stripe can do on its own (automatic card updates, retries, and expiring card emails), 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 expired_card means

Our suggestion: When you look for this failure, check the error's code as well as its decline_code, and the charge's outcome.reason, so you don't miss it in whichever field it shows up.

From: Stripe: Decline codes, Stripe: Error codes, Stripe API reference: Errors, Stripe: Testing, Stripe: Declines, Stripe: Card declines

Can Stripe update the card on its own?

Our suggestion: Since you can't tell which cards will be updated, don't wait for an automatic update once a renewal has failed with expired_card. Contact the customer anyway.

From: Stripe: How cards work, Stripe: Revenue recovery

Will Stripe retry it?

Our suggestion: Stripe's retry guide doesn't say whether retrying a card that has expired can succeed, so ask the customer for a new card instead of waiting on retries. Also 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

Our suggestion: Stripe's docs describe the expiring card email by the customer's default payment method or default source. If your subscriptions keep the card on the subscription's own default_payment_method, check in a sandbox that the email goes out for your setup. And if you also email the customer yourself, read Stripe's emails first so they don't contradict each other.

From: Stripe: Automate customer emails

What you can do

Our suggestion: Send the customer to your customer portal or your own billing page so the new card is used for future renewals, and make sure it lands in the field your retries use. Use the hosted invoice page only when you want this one invoice paid.

From: Stripe: Card declines, Stripe: Customer portal, Stripe: Hosted invoice page, 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 card for [Product] has expired

Hi [first name],

We tried to renew your [Product] subscription on [date], but the card ending in [last 4 digits] has expired.

To keep using [Product], please add a new card here: [your link to update the card]

If something looks wrong, just reply to this email.

[Your name]

Mistakes to avoid

From: Stripe: Decline codes, Stripe: How cards work, 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

From: Stripe: Testing, Stripe: Automate customer emails

Related

Sources

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.