incorrect_number
The card number is wrong.
| Group | Wrong or invalid card details |
|---|---|
| Retry | No automatic retry |
| Customer-facing | Safe 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
- Retrying the same card details won't fix this. Send the customer a card-update link right away.
- Keep the message short and neutral: the payment didn't go through, here's a secure link to update the card.
- Keep the subscription active for a short grace period while they update.
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.
| Network | Raw code | Meaning (our wording) |
|---|---|---|
| Visa | 14 | No such card number |
| Mastercard | 14 | Invalid card number |
Stripe's network decline code tables
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
- expired_card
- incorrect_address
- incorrect_cvc
- incorrect_zip
- invalid_cvc
- invalid_expiry_month
- invalid_expiry_year
- invalid_number
- All decline codes
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.