expired_cardThe card has expired

Stripe's expired_card decline means the card has expired and the customer needs another one. How it shows up in the API and what to send them.

Next step
Customer should use another card
Hard decline
Not on Stripe's list
Share the reason
Yes

What does expired_card mean?

The card has expired.

Stripe also uses expired_card as an API error code, with the advice to check the expiration date or use a different card.

What Stripe says to do

The customer needs to use another card.

What to tell the customer

You can tell the customer their card has expired and ask them to add a new one.

Example wording
The card on file has expired. Please add a new card to keep your account active.

Draft a full failed payment email for expired_card

Should you retry expired_card?

Not on the same card. Stripe's next step is another card. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.

Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.

Where expired_card shows up

On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.

Stripe also documents expired_card as a top-level API error code, so check error.code as well as decline_code when you handle it.

To test it in a Stripe sandbox: Stripe's test card 4000000000000069 returns expired_card as the error code, with no separate decline_code.

With local payment methods

Stripe also returns expired_card for local payment methods, with the Charge's outcome.reason set to partner_expired_card. Stripe's message: "The card registered with the payment provider has expired." Stripe says a retry might succeed after the customer resolves the issue with their account.

Get failed payments in Slack

ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as expired_card, and follow up from there.

Related decline codes

All Stripe decline codes