Stripe Failed Payment Explainer

Common reasons

• Card expired

  Most common single cause. Send a card-update email immediately.

• Insufficient funds

  Retry on payday (5 days later) is usually enough.

• Issuer declined / Do not honor

  Issuer-level decline. Usually transient. Retry and notify the customer.

• Authentication required (3D Secure)

  Send a hosted invoice link the customer can complete in-app.

• Lost / stolen card

  Card replaced. Card update is required, not just retry.

• Fraud hold

  Bank-side fraud filter. The customer needs to approve the merchant.

For the full list with recovery guidance, see the Stripe Decline Code Explainer.

What to do next

1. Listen for invoice.payment_failedwebhooks. Don't rely on Stripe's default emails alone.
2. Email the customer within an hour of the first failure. Plain text, no marketing voice.
3. Send a hosted update link, not instructions. Don't ask them to log in and find a settings page.
4. Follow up at day 3 and again at day 7 before the subscription pauses.
5. When the charge eventually succeeds, send a short thank-you so the customer feels resolved.

Sample failed payment email

Hi {{first_name}},

Quick note. Your last charge for {{product}} just failed. Usually that's an expired card or a hold from the bank.

If you want to keep your subscription active, you can update your card here:
{{update_link}}

It takes about 30 seconds. No need to reply — the charge will retry automatically once the card is good.

Thanks,
{{founder}}

Recovery checklist

• ✓ Webhook listener for invoice.payment_failed
• ✓ Customer email within an hour, plain text
• ✓ Hosted card-update link in the email
• ✓ Smart retry schedule tuned to decline code
• ✓ Day-3 and day-7 follow-up emails
• ✓ In-app banner for active sessions
• ✓ Final note before pausing access
• ✓ Thank-you email after recovery

When to use this

Use this as the reference page when wiring up your dunning flow, or when explaining to a teammate why a customer disappeared without ever cancelling. For the dollar estimate, run the Failed Payment Recovery Calculator.

Frequently Asked Questions