Decline Decoder

incorrect_number

The card number is wrong.

GroupWrong or invalid card details
RetryNo automatic retry
Customer-facingSafe to explain

What it means

The card number is wrong.

What Stripe's docs suggest

Have the customer re-enter the card number carefully and pay again. Source

Will a retry work?

Stripe's Smart Retries docs list incorrect_number as a hard decline. Scheduled retries keep counting, but a charge only goes through after the customer adds a new payment method. Source

What to tell the customer

A message you could send: “Your payment didn't go through because some card details didn't match. Please re-enter your card using this secure link.”

If this hit a subscription renewal

Similar card-network reason codes

Banks also return a raw network code. These raw codes have a similar meaning to incorrect_number. Stripe doesn't publish a one-to-one mapping, so treat this as our guide, not an official match.

NetworkRaw codeMeaning (our wording)
Visa14No such card number
Mastercard14Invalid card number

Stripe's network decline code tables

What are failed payments costing you?

Turn on JavaScript to use the calculator.

Example values only; use your own from your Stripe dashboard. Open the full calculator.

Questions

What does incorrect_number mean?

The card number is wrong.

Can I retry a incorrect_number decline?

Stripe's Smart Retries docs list incorrect_number as a hard decline. Scheduled retries keep counting, but a charge only goes through after the customer adds a new payment method. Source

What should I tell a customer about incorrect_number?

A message you could send: “Your payment didn't go through because some card details didn't match. Please re-enter your card using this secure link.”

Related codes

Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.