invalid_numberThe card number is invalid
Stripe's invalid_number decline means the card number is incorrect. What it means, how it compares to incorrect_number, and what to say.
- Next step
- Customer should correct their card details
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does invalid_number mean?
The card number is incorrect.
Stripe describes invalid_number and incorrect_number the same way. Only incorrect_number is on Stripe Billing's hard decline list.
What Stripe says to do
The customer needs to try again with the correct card number.
What to tell the customer
You can tell the customer the card number wasn't valid.
The card number isn't valid. Please check it and try again, or use a different card.
Should you retry invalid_number?
Yes, with a corrected number. 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 invalid_number 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 invalid_number as a top-level API error code, so check error.code as well as decline_code when you handle it.
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 invalid_number, and follow up from there.