How do I warn customers before their card expires in Stripe?

Updated

The short answer

Find the customers whose card will expire before their next renewal, then email them a link to update it a few weeks ahead. You can switch on Stripe's own expiring card emails in your Billing settings, build a check yourself with the Stripe API, or use a tool such as StripeReport that checks every subscription daily and emails only the customers who need it.

Why it's worth doing

An expired card is one of the most common reasons a subscription payment fails. Unlike low funds, it never fixes itself: retrying the same expired card won't work. Only the customer can add a new one.

A warning before the renewal turns a failed payment and a chase into a 30-second card update. It's also a friendlier email to get than "your payment failed".

Option 1: Stripe's built-in setting

Stripe Billing has a setting called "Send emails about expiring cards" in the Dashboard's Billing settings for customer emails. At the time of writing, it sends one email about a month before the customer's card expires, with a link to update it. It's quick to turn on, but it's timed from the card's expiry date rather than the next renewal, and you have limited control over the wording. See whether Stripe emails customers about expiring cards for more.

Option 2: Build your own check

If you have a developer, a daily job can do this:

  1. List your active subscriptions and each one's next renewal date (current period end).
  2. Read the expiry month and year of the card each customer pays with.
  3. A card works until the last day of its expiry month. If that is before the next renewal, the customer needs a warning.
  4. Email them a link to your Stripe customer portal, and remember who you emailed so you don't send twice.

Option 3: Use a tool

A tool connected to your Stripe account can run the same check every day and send the emails in your name, without code. Look for one that compares the expiry date with the renewal date, not just the expiry date, and that stops once the card is updated.

Related questions

How far ahead should I warn customers?

About three weeks before the renewal gives them time without being so early they forget. A second, shorter reminder a few days before catches anyone who missed the first.

What if the customer pays yearly?

Yearly plans need this most. A card can expire months before an annual renewal, and nobody notices until the charge fails. Compare the expiry date with the renewal date, not with today.

Where should the update button go?

To a secure page where the customer can change their card, such as your Stripe customer portal. Never ask customers to send card details by email.