Error codes
Soft decline
Stripe
invalid_number
The card number is incorrect.
What does invalid_number mean?
The invalid_number decline is returned when the card number fails network validation. Similar to incorrect_number, this means the specific number provided is not a valid card.
Is it a soft or hard decline?
Stripe classifies it as a soft decline, but practically retries on the same data will not succeed.
Common root causes
Customer mistyped the card number
OCR or auto-fill error
Test card number in live mode
Data corruption in stored card details
Recommended recovery steps
Prompt customer to re-enter card details
Use Stripe Elements for real-time validation
Use network tokens for recurring charges to avoid raw number issues
Consider wallet payments (Apple Pay, Google Pay)
How FlyCode handles invalid_number
FlyCode uses network tokens for recurring charges, sidestepping raw card number issues entirely. For initial charges, FlyCode integrates with validated checkout flows that catch number errors before submission.
What does invalid_number mean?
The invalid_number decline is returned when the card number fails network validation. Similar to incorrect_number, this means the specific number provided is not a valid card.
Is it a soft or hard decline?
Stripe classifies it as a soft decline, but practically retries on the same data will not succeed.
Common root causes
Customer mistyped the card number
OCR or auto-fill error
Test card number in live mode
Data corruption in stored card details
Recommended recovery steps
Prompt customer to re-enter card details
Use Stripe Elements for real-time validation
Use network tokens for recurring charges to avoid raw number issues
Consider wallet payments (Apple Pay, Google Pay)
How FlyCode handles invalid_number
FlyCode uses network tokens for recurring charges, sidestepping raw card number issues entirely. For initial charges, FlyCode integrates with validated checkout flows that catch number errors before submission.
What does invalid_number mean?
The invalid_number decline is returned when the card number fails network validation. Similar to incorrect_number, this means the specific number provided is not a valid card.
Is it a soft or hard decline?
Stripe classifies it as a soft decline, but practically retries on the same data will not succeed.
Common root causes
Customer mistyped the card number
OCR or auto-fill error
Test card number in live mode
Data corruption in stored card details
Recommended recovery steps
Prompt customer to re-enter card details
Use Stripe Elements for real-time validation
Use network tokens for recurring charges to avoid raw number issues
Consider wallet payments (Apple Pay, Google Pay)
How FlyCode handles invalid_number
FlyCode uses network tokens for recurring charges, sidestepping raw card number issues entirely. For initial charges, FlyCode integrates with validated checkout flows that catch number errors before submission.
Understanding This Decline Code
Extended content body
Frequently Asked Questions
What does invalid_number mean?
Can invalid_number be fixed by retrying?
Not with the same data. The number itself is invalid, so retries will always fail. Recovery requires correct card details or an alternate payment method.
How does FlyCode handle invalid_number?
FlyCode uses network tokens wherever issuers support them, avoiding raw card number issues on recurring subscription charges.
