Skip to content

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.

Abderrahim Ben Jazia, PhDBy · Founder of FlowMRR, previously built and sold AIS (Avance Immédiate Services), French tax-credit softwareUpdated:
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

  1. Do not retry: the number on file is wrong.
  2. Send the customer a link to re-enter their card in the customer portal or on the hosted invoice page.
  3. Suggest they type the number fresh rather than paste it from a note or an old saved entry.
  4. If the error repeats with a card the customer is sure is right, suggest a different card and a call to their bank.
  5. 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 free

Frequently 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.

Contact us
FlowMRR

Let's talk

A question, a technical issue or an idea for a partnership? Write to the FlowMRR team.