Decline Decoder

Free Stripe Decline Code Fix Sheet (PDF)

Every current Stripe card decline code on one printable sheet: whether a retry can work and the first thing to do. No email needed.

Want an alert when Stripe changes its codes? Email updates are Coming soon.

Stripe Decline Code Fix Sheet

What each card decline code means for a retry, and the first thing to do. Updated November 17, 2026.

CodeRetryFirst step
authentication_requiredNo automatic retryThe customer has to be present to approve the payment. Send them a link to a page where they can complete it.
authentication_not_handledNeeds the customerThe customer has to be present to approve the payment. Send them a link to a page where they can complete it.
approve_with_idRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
call_issuerRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
card_not_supportedRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
card_velocity_exceededRetry may workThis is often temporary. A retry a few days later, or around the 1st or 15th, can work.
currency_not_supportedRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
do_not_honorRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
duplicate_transactionRetry may workA later retry often works. Let your retry schedule handle it first.
expired_cardRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
fraudulentRetry possible, often needs the customerShow as generic decline
generic_declineRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
incorrect_addressRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
incorrect_cvcRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
incorrect_numberNo automatic retryRetrying the same card details won't fix this. Send the customer a card-update link right away.
incorrect_pinFix at the readerThis happens in person, at a card reader, not on subscription renewals.
incorrect_zipRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
insufficient_fundsRetry may workThis is often temporary. A retry a few days later, or around the 1st or 15th, can work.
invalid_accountRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
invalid_amountRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
invalid_cvcRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
invalid_expiry_monthRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
invalid_expiry_yearRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
invalid_numberRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
invalid_pinFix at the readerThis happens in person, at a card reader, not on subscription renewals.
issuer_not_availableRetry may workA later retry often works. Let your retry schedule handle it first.
lost_cardNo automatic retryShow as generic decline
merchant_blacklistRetry possible, often needs the customerShow as generic decline
new_account_information_availableRetry won't fix itRetrying the same card details won't fix this. Send the customer a card-update link right away.
no_action_takenRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
not_permittedRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
offline_pin_requiredFix at the readerThis happens in person, at a card reader, not on subscription renewals.
online_or_offline_pin_requiredFix at the readerThis happens in person, at a card reader, not on subscription renewals.
pickup_cardNo automatic retryDon't tell the customer the specific reason (the docs say to show it as a generic decline).
pin_try_exceededFix at the readerThis happens in person, at a card reader, not on subscription renewals.
processing_errorRetry may workA later retry often works. Let your retry schedule handle it first.
reenter_transactionRetry may workA later retry often works. Let your retry schedule handle it first.
restricted_cardRetry possible, often needs the customerDon't tell the customer the specific reason (the docs say to show it as a generic decline).
revocation_of_all_authorizationsNo automatic retryThe bank won't tell you more, so the customer has to ask, or use another card.
revocation_of_authorizationNo automatic retryThe bank won't tell you more, so the customer has to ask, or use another card.
security_violationRetry possible, often needs the customerDon't tell the customer the specific reason (the docs say to show it as a generic decline).
service_not_allowedRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
stolen_cardNo automatic retryShow as generic decline
stop_payment_orderRetry possible, often needs the customerThe bank won't tell you more, so the customer has to ask, or use another card.
testmode_declineRetry possible, often needs the customerCheck whether you're in test mode, or whether you're seeing an older code.
transaction_not_allowedNo automatic retryThe bank won't tell you more, so the customer has to ask, or use another card.
withdrawal_count_limit_exceededRetry may workThis is often temporary. A retry a few days later, or around the 1st or 15th, can work.
mobile_device_authentication_requiredNeeds the customerThe customer has to be present to approve the payment. Send them a link to a page where they can complete it.

Free from Decline Decoder (decline-decoder.pages.dev) · Based on Stripe's public docs; not affiliated with Stripe · General information, not advice

Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.