Braintree · Decline codes
What does Braintree 2005 “Invalid Credit Card Number” mean?
Checked
Braintree 2005 “Invalid Credit Card Number” means the number entered is not a valid card, usually because of a typo. It is a hard decline: the same number will keep failing. The shopper should re-enter the card carefully. If the decline repeats with the correct number, Braintree says the shopper needs to contact their bank.
- Type
- Hard decline
- Who declined
- The shopper's bank
- Retry
- Only after the shopper fixes the number
- Shopper action
- Re-enter the card number carefully
- Merchant action
- Ask the shopper to check the number; contact the bank if it repeats
What PlatformDTC does
PlatformDTC does not connect to Braintree. The matching Stripe answer is incorrect_number: PlatformDTC adds a plain hint at checkout, never moves the shopper to a backup processor for it, and never retries it on a renewal.
Why it happens
A digit was mistyped, digits were swapped, or the card was copied wrong. Less often, the card number has been cancelled at the bank.
What the shopper can do
Re-enter the 15 or 16 digits exactly as printed. If it still fails, call the bank.
What the store can do
Make sure your payment form shows a clear error near the card field. Repeated invalid numbers from one visitor can be a sign of card testing; Braintree's risk threshold rules can limit repeated attempts.
For developers
Braintree returns processor_response_code 2005 with processor_response_text “Invalid Credit Card Number” and processor_response_type “hard_declined” on the Transaction object.
Frequently asked questions
- Does Braintree 2005 mean fraud?
- Usually not; most are typos. Many failed numbers from one visitor in a short time can point to card testing.
- Can the shopper try again?
- Yes, after correcting the number. Resending the same number will fail again.
Sources
- Declines: authorization decline codes — Braintree (PayPal)
- Transaction response object — Braintree (PayPal)
- Decline codes — Stripe
Related
- 2008 — The card number has the wrong number of digits.
- 2006 — The expiry date entered is wrong.
- 2010 — The security code (CVV) entered is wrong.
- 2007 — The card number is not on file at the bank (no account).
- 2009 — The card number does not match any card-issuing bank.
- 2011 — The bank wants the merchant to phone for an approval code.