Blog/Stripe failed payment emails
Payments · Recovery basics

Stripe failed payment emails: Setup, limits, and a template

Stripe's failed payment emails notify customers after each failed subscription payment, and give them a link to update their card. Here's how to turn them on, where the link goes, what you can customize, where they stop working, and a follow-up email you can send yourself.

What are Stripe failed payment emails?

When a subscription payment fails, Stripe can email your customer about it. Stripe's customer emails documentation says that once you turn the setting on, Stripe sends an email after each failed payment. It lets the customer know their recent subscription payment failed and gives them a chance to update their payment method so the payment can be retried.

The email matters most for failures a retry can't fix. If a card has expired or been replaced, trying it again just fails again, and the customer has to supply a new one. Our guides to Stripe Smart Retries and Stripe decline codes cover which failures retries can solve.

These emails are one of several recovery tools Stripe lists in its revenue recovery documentation, alongside Smart Retries, recovery analytics, no-code automations, and automatic card updates.

How to turn on Stripe failed payment emails

These steps follow Stripe's customer emails documentation, and they all happen in the Stripe Dashboard.

  1. Open the revenue recovery email settings

    You'll find them in the Stripe Dashboard. Stripe also lists these emails in your subscriptions and emails settings, under Email notifications and customer management.

  2. Turn on Send emails when card payments fail

    This is the setting for failed payment emails. When it's on, Stripe sends the customer an email after each failed payment.

  3. Choose where the link goes

    Under Payment method updates, pick a Stripe-hosted customer portal or your own subscription management page. You can't use Stripe's page for some emails and your own URL for others.

  4. Set your branding

    These emails use your branding settings, so add your icon and choose your brand and accent colors before you test.

  5. Test it in a sandbox

    Select a sandbox, set the customer's email address to the confirmed email address of an active team member, and trigger a failed payment. Stripe says it can send failed payment notifications to that address.

  6. Check the email log

    On the Customers page, Stripe keeps logs of the emails it sent in the last 60 days, including failed payment attempts. The logs update daily and don't include emails from the current date.

Stripe's failed payment, trial ending, renewal reminder, expiring card, and payment confirmation emails all include a link where the customer can update their payment method. You choose the destination: a Stripe-hosted customer portal, or your own subscription management page.

With the Stripe-hosted option, the email carries a secure, private URL. On that page the customer can update their payment method for that subscription and pay any outstanding invoices. Otherwise, Stripe uses the new payment method the next time a scheduled payment is attempted.

If you send customers to your own page, Stripe adds a stripe_source parameter to the link so you can tell which email it came from. For failed payment emails the value is failed_payment.

Stripe's no-code customer portal also gives you a login link you can put on your site or send to customers yourself. Customers sign in with their email address, and Stripe emails them a login link that opens their portal session. Stripe says it also adds the link to your customer emails.

Can you customize Stripe failed payment emails?

Some of it. Branding is the main control. In Stripe's branding settings you can set an icon, a logo, a brand color, and an accent color. Emails use the icon, the brand color, and the accent color as their background. They don't use the logo.

By default, Stripe sends failed payment notifications from the stripe.com domain. If you verify your own domain, Stripe can send them from that domain instead.

What Stripe's documentation for these emails doesn't describe is a way to change the wording. Stripe's no-code Automations don't fill that gap. An automation can email your own team when a payment fails, and it can email a customer a cancellation confirmation when a subscription is canceled, but the actions listed for a failed subscription payment don't include emailing the customer. Stripe's own recipe for a custom dunning flow, aimed at annual subscribers, works the same way: it sets a Smart Retries policy, adds an optional 7-day grace period for manual outreach, then cancels the subscription and marks the invoice uncollectible. None of those steps emails the customer.

When Stripe's failed payment emails stop working

Stripe's emails cover the early part of a failed payment. They have three limits worth knowing.

They follow the retries

Stripe sends one email after each failed payment, so the emails follow your retry schedule. When the retries run out, there's no further failed payment to trigger another. What happens to the subscription then depends on your failed payment settings. See our guide to what happens when retries run out.

The link can stop working

Stripe lists conditions that make the link to its hosted page stop working. They include the subscription's status changing to canceled, incomplete_expired, or unpaid, and the subscription's current renewal period expiring. So if your failed payment settings cancel the subscription or mark it unpaid after the last retry, the hosted-page link in the earlier emails stops working.

Manually invoiced subscriptions get no link

Stripe doesn't include a link to its hosted page if the subscription is set to send an invoice manually. Recurring invoices set up that way have a separate setting, Send reminders if a recurring invoice hasn't been paid. It sends a reminder before, on, or after the due date, using a set of predefined options. Stripe's invoicing documentation covers it.

Other Stripe emails that prevent failed payments

Failed payment emails work best alongside the other notifications Stripe offers in the same settings:

  • Expiring card emails. Stripe emails the customer one month before the card on file expires, when it's their default payment method or default source.
  • Upcoming renewal reminders. Stripe only sends these for subscriptions that charge automatically, not for subscriptions that send an invoice. The timing comes from your upcoming renewal event settings.
  • Trial ending reminders. An email 7 days before a free trial ends.
  • Payment confirmation emails. Some payments, like those that use 3D Secure, need the customer to act. Stripe can email a link to confirm the payment, and keep sending reminders until it's confirmed or expires.

Separate from email, Stripe automatically attempts to update saved card details when a customer receives a new card. It depends on the issuer taking part. It's widely supported in the United States, where Stripe can update most American Express, Visa, Mastercard, and Discover cards, and support varies by country elsewhere.

A follow-up email you can send yourself

Stripe's emails go out on Stripe's schedule and in Stripe's words. For customers worth a personal note, you can send your own. Keep it short, name the amount, and give one link.

For the link, you can use your customer portal login link or the invoice's hosted payment page. Stripe's hosted invoice page lets the customer pay with any payment method you've enabled.

SubjectYour payment to [Your business] didn't go through

Hi [Name],

Your [amount] payment to [Your business] didn't go through. This can happen when a card expires or the bank declines the charge, and it's quick to fix.

You can update your payment method here: [link]

If you've already sorted it out, thank you, and please ignore this note.

Thanks,

[Your name]

SubjectLast reminder: update your payment method

Hi [Name],

We still haven't been able to take your [amount] payment. To keep your [plan or service] going, please update your payment method here: [link]

If something isn't right, just reply to this email and we'll sort it out.

Thanks,

[Your name]

Replace everything in brackets before you send. Send the second one a few days after the first, and adjust the wording to match your terms with the customer.

Stripe failed payment emails FAQ

Does Stripe send an email when a payment fails?

Yes, if you turn it on. Enable "Send emails when card payments fail" in your revenue recovery email settings, and Stripe sends the customer an email after each failed subscription payment. The email gives them a way to update their payment method so the payment can be retried.

Are Stripe's failed payment emails dunning emails?

They're one kind. Dunning is the billing term for following up with a customer about a payment that failed, and a failed payment email is usually the first step. Stripe uses the word in its own documentation, including a custom dunning flow recipe for Automations.

How many failed payment emails does Stripe send?

One after each failed payment, according to Stripe's documentation. Because the email is tied to failed payments, the number follows your retry schedule, and there's nothing to trigger another once the retries run out.

Can I customize the wording of Stripe's failed payment email?

Stripe's documentation for these emails covers branding (an icon, a brand color, and an accent color), where the link goes, and sending from your own domain. It doesn't describe a way to change the wording.

Where does the link in Stripe's failed payment email go?

To a Stripe-hosted page where the customer can update their payment method, or to your own subscription management page, whichever you choose in your settings. You can't use Stripe's page for some emails and your own URL for others.

Does Stripe email customers when an invoice payment fails?

It can. Stripe's invoicing documentation lists emails for failed payment attempts and for one-off invoices that haven't been fully paid. For recurring invoices that Stripe sends for payment, turn on the setting "Send reminders if a recurring invoice hasn't been paid". The failed payment email in this guide covers subscription payments.

Does Stripe update expired cards automatically?

It tries to. Stripe works with the card networks to update saved card details when a customer gets a new card. That depends on the issuer taking part: it's widely supported in the United States for most American Express, Visa, Mastercard, and Discover cards, and support varies by country elsewhere.

What happens after the last failed payment email?

The emails follow failed payments, so they stop when payment attempts stop. If your settings then cancel the subscription or mark it unpaid, the link in the earlier emails stops working. After that you can follow up yourself or use a tool like Recoura.

Recoura's role

Stripe's emails and retries cover the first stretch of a failed payment. What's left is hard declines, reissued cards the updater didn't catch, and subscriptions that ended up canceled or unpaid when the retries ran out. Our comparison of failed payment recovery tools covers which tools pick up from there.

Recoura connects to your Stripe account. For soft declines, it steps in only after Smart Retries has finished. Hard declines, which retries can't fix because the customer has to update their card, don't wait for that. It flags what's still unpaid, checks it against your live Stripe data to confirm it's still owed, and then emails the customer, in your business's name, with a link to the invoice's Stripe-hosted payment page. You set the wording and the schedule, or send one by hand for the customers who deserve a personal touch. Where Stripe allows it, Recoura also points the subscription at the card the customer paid with, so the next renewal doesn't fail on the old one. 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