generic_decline: Stripe Subscription Fix
Root cause
Stripe returns generic_decline when the issuing bank rejects the subscription charge without sending a machine-readable reason that the merchant can act on.
Symptoms
- • Stripe declines the invoice with generic_decline and no useful subreason
- • Shopify or Recharge shows a failed recurring payment without a recoverable technical fix
- • The same card may still work for unrelated purchases but not for this off-session charge
- • Support agents cannot see the bank's exact decision in Stripe Dashboard
How to fix it
Confirm the issuer gave no detail
Open the failed charge or invoice in Stripe Dashboard and verify the decline code is generic_decline. This confirms Stripe did not receive a usable reason from the bank. Do not treat it like insufficient_funds or another decline with a known retry strategy.
Open in admin →Ask the customer to call their bank
Tell the customer the bank blocked the recurring charge and only the bank can explain or remove the block. Give them the amount, merchant descriptor, and date of the failed charge so they can reference it accurately. Avoid promising that another retry will succeed without issuer action.
Collect a different payment method
If the customer cannot get the bank to approve recurring charges, send a payment update link and ask for another card or wallet-supported method. generic_decline has no reliable merchant-side retry path. Continuing to retry the same credential usually produces the same failure.
Open in admin →Frequently asked questions
Can a merchant fix generic_decline without the customer?
Usually no. generic_decline means the issuer declined the charge but did not tell Stripe or the merchant why. Because there is no actionable technical reason, the merchant cannot tune retry timing or change request parameters with confidence. The customer has to contact the bank or provide a different payment method.
Should I keep retrying a subscription after generic_decline?
No, not as a primary recovery strategy. Unlike insufficient_funds, generic_decline does not point to a temporary balance issue with a known timing pattern. One uncontrolled retry may be harmless, but repeated retries usually waste dunning attempts. The correct next step is customer outreach telling them to call the bank or replace the card.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →