Free tools / Stripe decline codes / incorrect_number
Stripe incorrect_number: wrong card numbers on subscriptions
incorrect_number means the card number was not accepted as correct, even though it may look like a real card number. The customer has to re-enter their card or use another one; resending the same number will not work.
- Decline code
- incorrect_number
- Type
- Card update needed
- Who can fix it
- The customer — needs to act
- Will a retry help?
- No: do not retry
What it means
The card number is wrong.
The card on file is expired, wrong or closed. Retrying will fail every time; only the customer can replace it.
Why it happens
- A typo in the card number that still passes the basic format check.
- A number that may belong to a card since replaced, which the issuer no longer recognises.
- The customer entered digits from a different card than the one they meant to use.
What to do
- Do not retry: the number on file is wrong.
- Send the customer a link to re-enter their card in the customer portal or on the hosted invoice page.
- Suggest they type the number fresh rather than paste it from a note or an old saved entry.
- If the error repeats with a card the customer is sure is right, suggest a different card and a call to their bank.
- Once the new details are saved, collect the open invoice.
Should you retry?
No retry with the same number. The customer must re-enter the card or add another one before you charge again.
What to tell the customer
Short and neutral, ready for a checkout error, a billing page or a support reply. No placeholders — ready to paste.
The card number is incorrect. Please check it and enter it again.
Customer email template
Neutral wording for this situation. Replace {name}, {product}, {link} and {company}.
Hi {name},
The card we have on file for {product} can no longer be charged (it looks expired or invalid). To keep your access, please add a new card here: {link}
Thanks,
{company}Handling many failed payments? See how FlowMRR helps you prioritize failed Stripe payments by revenue at risk. Want a ranked list from your own account? Try the free failed payment audit.
Try FlowMRR freeFrequently asked questions
incorrect_number vs invalid_number: what is the difference?
invalid_number generally means the digits are not a valid card number at all, such as a format error. incorrect_number means the number may look valid but was not accepted as correct. Both need the customer to enter their card again.
How can a saved card suddenly have an incorrect number?
If the card worked before, the issuer may have replaced or renumbered it. Automatic card updates catch some of these, not all; when they do not, the customer has to enter the new card.
Can I correct the number myself?
No. Card numbers should only be entered by the customer through a secure form, such as Stripe's customer portal or hosted invoice page. Never ask for card details by email.
Other Stripe decline codes
- generic_decline
- do_not_honor
- insufficient_funds
- card_declined
- expired_card
- authentication_required
- card_velocity_exceeded
- lost_card
- stolen_card
- fraudulent
- pickup_card
- incorrect_cvc
- processing_error
- try_again_later
- transaction_not_allowed
- restricted_card
- withdrawal_count_limit_exceeded
- card_not_supported
- currency_not_supported
- invalid_account
- stop_payment_order
- Look up any decline code
- The complete list of decline codes