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.
The card on file has expired. Please add a new card to keep your account active.
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.