incorrect_numberThe card number is wrong
Stripe's incorrect_number decline means the card number is wrong. It's a hard decline, so Billing won't retry it. What to tell the customer.
- Next step
- Customer should correct their card details
- Hard decline
- Yes, on Stripe's list
- Share the reason
- Yes
What does incorrect_number mean?
The card number is incorrect.
What Stripe says to do
The customer needs to try again with the correct card number.
What to tell the customer
You can tell the customer the card number was wrong and ask them to enter it again.
The card number didn't go through. Please check it and enter it again, or use a different card.
Should you retry incorrect_number?
Only with a corrected number. Stripe lists this code as a hard decline. Stripe Billing won't retry the invoice on its own: scheduled retries stay on the invoice, but they only run after the customer adds a new payment method.
Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.
Where incorrect_number shows up
On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.
Stripe also documents incorrect_number as a top-level API error code, so check error.code as well as decline_code when you handle it.
To test it in a Stripe sandbox: Use 4242424242424241, a number that fails the Luhn check. Stripe returns incorrect_number as the error code, with no separate decline_code.
Get failed payments in Slack
ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as incorrect_number, and follow up from there.