Decline Decoder

invalid_number

The card number is wrong.

GroupWrong or invalid card details
RetryRetry won't fix it
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 can retry this code, but retrying the same wrong details won't help. The customer has to correct or replace the card.

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 invalid_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 invalid_number mean?

The card number is wrong.

Can I retry a invalid_number decline?

Stripe can retry this code, but retrying the same wrong details won't help. The customer has to correct or replace the card.

What should I tell a customer about invalid_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.