Stripe Decline Codes, Explained
All 50 Stripe card decline codes in plain English: what each one means, whether a retry can work, and what to do next. Grouped by cause.
Get the free fix sheet (PDF)Failed-payment calculator
Wrong or invalid card details
| Code | Meaning | Retry |
|---|---|---|
expired_card | The card is past its expiration date. | Retry won't fix it |
incorrect_address | The address the customer entered doesn't match. | Retry won't fix it |
incorrect_cvc | The security code (CVC) is wrong. | Retry won't fix it |
incorrect_number | The card number is wrong. | No automatic retry |
incorrect_zip | The billing postal code is wrong. | Retry won't fix it |
invalid_cvc | The security code (CVC) is wrong. | Retry won't fix it |
invalid_expiry_month | The month in the expiry date was rejected as invalid. | Retry won't fix it |
invalid_expiry_year | The year in the expiry date was rejected as invalid. | Retry won't fix it |
invalid_number | The card number is wrong. | Retry won't fix it |
new_account_information_available | The card, or the account behind it, isn't valid. | Retry won't fix it |
Funds and limits
| Code | Meaning | Retry |
|---|---|---|
card_velocity_exceeded | The customer went over the balance, credit limit or transaction limit on the card. | Retry may work |
insufficient_funds | There isn't enough money or credit on the card to cover the payment. | Retry may work |
withdrawal_count_limit_exceeded | The customer went over the balance or credit limit on the card. | Retry may work |
The bank said no
| Code | Meaning | Retry |
|---|---|---|
approve_with_id | The bank couldn't authorize the payment. | Retry possible, often needs the customer |
call_issuer | The bank declined and didn't say why. | Retry possible, often needs the customer |
card_not_supported | This card can't be used for this kind of purchase. | Retry possible, often needs the customer |
currency_not_supported | The card doesn't work with the currency you charged in. | Retry possible, often needs the customer |
do_not_honor | The bank declined for a reason it didn't share. | Retry possible, often needs the customer |
generic_decline | The bank declined for an unknown reason, or Stripe's fraud tools (Radar or Adaptive Acceptance) blocked the payment. | Retry possible, often needs the customer |
invalid_account | The card, or the account behind it, isn't valid. | Retry possible, often needs the customer |
invalid_amount | The amount isn't valid or is more than the card allows. | Retry possible, often needs the customer |
no_action_taken | The bank declined for an unshared reason. | Retry possible, often needs the customer |
not_permitted | The payment isn't allowed. | Retry possible, often needs the customer |
revocation_of_all_authorizations | The bank declined for an unshared reason. | No automatic retry |
revocation_of_authorization | The bank declined for an unshared reason. | No automatic retry |
service_not_allowed | The bank declined for an unshared reason. | Retry possible, often needs the customer |
stop_payment_order | The bank declined for an unshared reason. | Retry possible, often needs the customer |
transaction_not_allowed | The bank declined for an unshared reason. | No automatic retry |
Fraud, lost or stolen
| Code | Meaning | Retry |
|---|---|---|
fraudulent | Stripe suspects the payment is fraudulent. | Retry possible, often needs the customer |
lost_card | The card has been reported lost. | No automatic retry |
merchant_blacklist | The payment matched an entry on your own Stripe block list. | Retry possible, often needs the customer |
pickup_card | The customer can't use this card for this payment. It may have been reported lost or stolen. | No automatic retry |
restricted_card | The customer can't use this card for this payment. It may have been reported lost or stolen. | Retry possible, often needs the customer |
security_violation | The bank declined for an unshared reason. | Retry possible, often needs the customer |
stolen_card | The card has been reported stolen. | No automatic retry |
Authentication needed
| Code | Meaning | Retry |
|---|---|---|
authentication_required | The bank wants the cardholder to verify the payment, for example with 3D Secure, before it will approve it. | No automatic retry |
authentication_not_handled | The bank asked for authentication, the payment went ahead without it, and the bank declined again. | Needs the customer |
mobile_device_authentication_required | The bank wants the payment confirmed on the customer's phone or wallet. | Needs the customer |
Temporary or processing problems
| Code | Meaning | Retry |
|---|---|---|
duplicate_transaction | A payment with the same amount and card details was sent moments ago. | Retry may work |
issuer_not_available | Stripe couldn't reach the bank to get an approval. | Retry may work |
processing_error | Something went wrong while the card was being processed. | Retry may work |
reenter_transaction | The bank couldn't process the payment for an unknown reason. | Retry may work |
In-person card reader (PIN)
| Code | Meaning | Retry |
|---|---|---|
incorrect_pin | The PIN is wrong. This code only applies to payments taken on a card reader. | Fix at the reader |
invalid_pin | The PIN is wrong. | Fix at the reader |
offline_pin_required | The card needs a PIN for this payment. | Fix at the reader |
online_or_offline_pin_required | The card needs a PIN for this payment. | Fix at the reader |
pin_try_exceeded | Too many wrong PIN attempts. | Fix at the reader |
Setup, testing and deprecated codes
| Code | Meaning | Retry |
|---|---|---|
do_not_try_again | The bank declined for an unshared reason. Stripe marks this code as deprecated. | Retry possible, often needs the customer |
testmode_decline | The payment used one of Stripe's test card numbers, which can't make real charges. | Retry possible, often needs the customer |
try_again_later | The bank declined for an unshared reason. Stripe marks this code as deprecated. | Retry possible, often needs the customer |
More references
Checked against Stripe's public docs on November 17, 2026. Codes and guidance can change; always confirm in the official decline code list.