incorrect_number: Stripe Subscription Fix
Root cause
Stripe returns incorrect_number when the card's primary account number was entered incorrectly during initial payment method collection, so the subscription never received a valid recurring credential.
Symptoms
- • Stripe declines the initial subscription payment with incorrect_number
- • The customer reports that checkout failed before the subscription could start
- • No successful card token is attached to the customer for future renewals
- • Retrying with the same mistyped number reproduces the error immediately
How to fix it
Verify it is a setup failure
Open the failed Stripe payment and confirm the decline happened during the first card capture step. incorrect_number is a data-entry problem, not a downstream subscription retry issue. That means your team should focus on getting a clean card entry rather than investigating dunning or webhook behavior.
Open in admin →Collect the card number again
Ask the customer to re-enter the full PAN directly from the card, not from memory or a screenshot. If they are using autofill, have them disable it for one attempt in case an outdated card was inserted. A correct fresh entry usually resolves this immediately.
Offer an alternate payment method
If the customer still cannot complete setup, ask them to use a different card or a supported wallet. Some customers repeatedly enter an old cancelled card number that matches the same brand and last four digits they expect. Capturing a different credential is faster than endless manual retries.
Frequently asked questions
Does incorrect_number ever mean the bank is blocking the subscription?
No. incorrect_number is not an issuer policy decision; it means the card number itself was invalid or mismatched before the issuer could authorize the charge normally. The fix is to capture the right PAN. Tuning retries, dunning cadence, or bank contact scripts will not solve a number-entry mistake during setup.
Why do merchants sometimes mistake incorrect_number for a renewal bug?
Because the customer often says their subscription 'didn't work,' even though the card was never successfully stored in the first place. If support only looks at the subscription object and not the first failed Stripe event, they may assume a later renewal failed. The Stripe timeline will show that onboarding never completed successfully.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →