What should I say in an email when a customer's card is declined?

Updated

The short answer

Say what happened, why (in plain words), and the one thing they need to do, with a button to do it. Keep it short and friendly: most declines are an expired card or a bad week for money, not someone trying to avoid paying. The best wording depends on the decline reason, so use a different version for each.

The shape of a good declined card email

  1. Greet them by first name if you have it.
  2. Say what didn't go through: "We couldn't charge your card for Shiftbird Team ($49.00)."
  3. Give the reason in everyday words. Never use bank terms or words like "stolen".
  4. Ask for one action, with one button.
  5. Say when you'll try again, if you will.
  6. Sign off from a real person or your business, and let replies reach you.

Wording for each decline reason

  • Not enough funds: "Your bank said there wasn't enough available on the card. We'll try again automatically on November 12. You can also pay now, or use a different card." Button: Pay now.
  • Expired card: "The card on your account has expired. Add your new card to keep your subscription running. It takes a minute." Button: Update card.
  • Wrong details: "Your bank didn't accept the card details we have, such as the security code or ZIP code. Enter your card again to keep your subscription running." Button: Update card.
  • Card blocked or closed: "Your bank won't allow charges on this card any more. Please use a different card." Button: Use a different card.
  • Bank wants approval: "Your bank wants you to approve this payment. Open the secure page below to approve it." Button: Approve payment.

A full example

What not to say

  • Don't threaten to delete their account in the first email.
  • Don't paste the raw decline code. "do_not_honor" means nothing to a customer.
  • Don't hint that they did something wrong. Most of the time, nobody did.
  • Don't send them to log in and hunt for billing settings. Link straight to the payment page.

Related questions

Where do I find why a Stripe payment was declined?

Open the payment in your Stripe Dashboard. The decline code and Stripe's explanation are in the payment's details.

Should I tell the customer the exact decline reason?

Tell them what to do about it, in plain words. "Your card has expired" helps. "Your card was reported stolen" doesn't: for blocked cards, just ask for a different card.

How formal should the email be?

Write it the way you'd talk to a customer you like. Short, warm and clear beats formal and long.