What is generic_decline?
generic_decline is the decline code Stripe returns when the card-issuing bank rejects a transaction without a specific reason, or with a reason Stripe cannot map to a more precise code. Think of it as the catch-all bucket for declines that don't have a more descriptive label.
The customer sees a message like "Your card was declined." Developers see decline_code: "generic_decline" in the Stripe Dashboard or the API response.
What can cause generic_decline?
This is the broadest decline code and can hide many underlying issues:
- Bank fraud prevention. The transaction looked suspicious based on amount, location, or merchant category.
- Insufficient funds. Some banks return
generic_declineinstead ofinsufficient_funds. - International payments blocked. The card is not configured to process cross-border transactions.
- Card blocked or suspended. A temporary hold placed by the bank.
- Transaction limit reached. The card's daily or monthly spend cap has been hit.
- Bank-side technical error. The issuer's server returned an unrecognized error code.
- Card type incompatibility. The merchant does not accept this category of card.
What to do when you see generic_decline
- Check your balance and limits. Make sure you have enough funds and haven't hit any spending caps.
- Verify the card is active. Log into your banking app and confirm the card status.
- Check international payment settings. If the service is based abroad, ensure cross-border transactions are enabled on your card.
- Call your bank. A representative can see the internal decline code and explain the actual reason.
- Try a different card. If the payment is urgent, use another payment instrument.
- Retry later. If a bank-side technical issue is the cause, retrying after a few hours often works.
FAQ
How is generic_decline different from do_not_honor?
do_not_honor is a specific ISO 8583 code (05) that the bank explicitly returned. generic_decline is how Stripe labels a decline when no specific sub-code is present or recognized.
Is generic_decline a Stripe problem or a bank problem? Almost always a bank decision. Stripe simply relays the bank's response. Contact your bank, not Stripe support.
Can generic_decline be a false positive? Yes. Aggressive fraud prevention systems sometimes block legitimate transactions. A quick call to your bank often resolves it immediately.
If your bank regularly returns generic_decline on international payments, Marix virtual cards are purpose-built for cross-border transactions and avoid many of the triggers that cause this error.

