AltorLabFree Scan →
HomeError Codesincorrect_cvc
stripeshopify

incorrect_cvc: Stripe Subscription Fix

Root cause

Stripe returns incorrect_cvc when the card verification code entered during the initial payment method setup does not match the issuer's record, and recurring renewals themselves do not send CVC data.

Symptoms

How to fix it

1

Confirm the failure happened at signup

Check the Stripe PaymentIntent or SetupIntent timeline and verify the error occurred during the initial checkout or payment method save flow. Subscription renewals do not transmit CVC, so an incorrect_cvc event means the problem happened when the customer first entered card details. This helps support avoid chasing a nonexistent renewal bug.

Open in admin →
2

Have the customer re-enter card details

Ask the customer to re-enter the card number, expiration date, and CVC carefully from the physical card. Copying a saved wallet token into a manual field can cause mistakes, especially if the customer guesses the security code. If the card still fails, advise them to try another card or confirm the CVC with their issuer.

3

Check your setup intent implementation

Verify that your checkout is creating a fresh Stripe PaymentMethod or SetupIntent rather than reusing a partially failed object. A bad retry flow can surface the same setup error repeatedly even after the customer corrects the form. Make sure the front end clears failed card state before retrying.

Frequently asked questions

Why does incorrect_cvc imply the issue happened during setup?

Because off-session subscription renewals do not ask for or transmit the CVC again. The bank can only compare CVC during the initial card entry or an on-session payment authentication flow. If Stripe shows incorrect_cvc, the payment method was entered incorrectly at setup and never became a valid recurring credential for future renewals.

Can a saved card start failing later with incorrect_cvc on renewal?

Not in a normal recurring billing flow. Once the card is stored, renewals reference the tokenized payment method and do not submit a new CVC value. If your logs show incorrect_cvc later, look for a re-authentication flow, card re-entry form, or a custom payment update step where the customer typed card details again.

Detect this error automatically

Free cross-stack scan finds all billing errors in 60 seconds.

Run Free Scan →