Stripe decline codes explained

All 70 decline codes in Stripe's reference, with what each one means, what to tell the customer, and whether a retry can work. For the common codes on one page, read the decline codes cheat sheet.

Based on Stripe's decline codes reference, checked .

70 codes in 8 groups

Customer should correct their card details

Stripe's next step is to try again with the right card number, CVC, expiry date, address, or postal code.

Customer should authenticate or use a PIN

The bank wants extra verification: 3D Secure, a PIN on a card reader, or another tap of a phone.

Customer should use another card

Stripe's next step is a different card or payment method, because this one can't cover the payment.

Customer should contact their bank

The issuer declined and only it can tell the cardholder why. Stripe's next step is to contact the card issuer.

Retry may work

Stripe's next step is to attempt the payment again, then contact the issuer if it still fails.

Don't tell the customer the reason

Stripe says to present these like generic_decline and not share the real reason.

Check your own setup

The decline points to something on your side: a repeated charge or a test card.

Local payment method codes

Codes Stripe uses for non-card payment methods such as BLIK, with Stripe's own note on whether a retry can succeed.

See failed payments as they happen

ChargeBell posts a Slack alert when Stripe sends payment_intent.payment_failed, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to read its decline code, then look it up here.

Stripe decline code questions

Where do I find the decline code for a payment?

In the Stripe Dashboard, open the failed payment. In the API, read decline_code on the PaymentIntent's last_payment_error, or outcome.reason on the Charge. Card declines usually arrive with the error code card_declined and the specific reason in decline_code.

What is the difference between a decline code and an advice code?

The decline code says why the payment failed. The advice_code on the charge outcome says what to do next: try_again_later, do_not_try_again, or confirm_card_data.

Which Stripe decline codes are hard declines?

Stripe Billing lists incorrect_number, lost_card, pickup_card, stolen_card, revocation_of_authorization, revocation_of_all_authorizations, authentication_required, and transaction_not_allowed as hard decline codes, along with the Radar outcome highest_risk_level. Billing keeps retries scheduled for these but only runs them after the customer adds a new payment method.

Which decline reasons shouldn't I show the customer?

Stripe says not to reveal fraudulent, lost_card, stolen_card, or merchant_blacklist, and to present them like generic_decline. For local payment methods, lost_or_stolen_card should be presented as partner_generic_decline.

How many times should I retry a declined card?

Stripe recommends at most eight retries for charges that allow retries. Card networks limit retries on a single charge, and issuers can treat extra attempts as possible fraud.

Know about failed payments before your customers do

ChargeBell sends Stripe payments, failures, and disputes to Slack in plain English. Read-only access, set up in about two minutes.

Create your workspace