incorrect_cvcThe CVC is wrong
Stripe's incorrect_cvc decline means the card's security code was wrong. How it shows up, what to tell the customer, and how to test it.
- Next step
- Customer should correct their card details
- Hard decline
- Not on Stripe's list
- Share the reason
- Yes
What does incorrect_cvc mean?
The CVC number is incorrect.
Stripe's card decline guide says that when CVC or address checks fail as the customer adds a card, you should ask them to verify both before you charge it.
What Stripe says to do
The customer needs to try again with the correct CVC.
What to tell the customer
You can tell the customer the security code was wrong. It's often a typo.
The security code (CVC) didn't match. Please check the 3 or 4 digits on your card and try again.
Should you retry incorrect_cvc?
Yes, after the customer enters the right CVC. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.
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_cvc 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_cvc 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: Stripe's test card 4000000000000127 returns incorrect_cvc as the error code, with no separate decline_code. Provide any three-digit CVC; Stripe skips the check if you leave it out.
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_cvc, and follow up from there.