account_closed: Stripe Subscription Fix
Root cause
Stripe returns account_closed when the cardholder's linked bank or card account has been closed by the issuer, making the stored subscription payment method permanently unusable for future renewals.
Symptoms
- • Stripe declines the renewal with decline_code: account_closed
- • Every retry on the same stored payment method fails the same way
- • The subscription stays active in app dashboards while revenue is no longer collected
- • Customers typically need a replacement card or new bank account rather than a retry
How to fix it
Stop all automated retries now
Treat account_closed as a permanent failure like lost_card, not as a soft decline. Continued retries do not recover revenue because the issuing account no longer exists for billing purposes. Pause dunning on that payment method immediately to avoid pointless failures.
Open in admin →Request a new payment credential
Send the customer a direct payment update link and ask them to replace the closed account with another valid card or bank-backed method. Keep the wording simple and operational. The important point is that the old account cannot be revived for recurring charges.
Open in admin →Cancel if no update arrives
If the customer does not update payment within your dunning window, cancel or pause the subscription in every connected system so fulfillment does not continue unpaid. account_closed will not self-resolve over time. Merchants should treat it as a hard stop that requires a replacement credential.
Frequently asked questions
How is account_closed different from insufficient_funds?
insufficient_funds means the account exists but lacked balance at that moment, so retry timing matters. account_closed means the underlying account has been shut down and cannot process future charges at all. There is no meaningful retry schedule for account_closed. The customer must supply a different payment method before the subscription can bill again.
Should account_closed be handled like lost_card in dunning rules?
Yes. Both are permanent payment method failures where repeating the same charge is not expected to work. Merchants should suppress automatic retries, send a payment update request quickly, and then cancel or pause if the customer does not respond. Treating account_closed like a soft decline only burns dunning attempts and delays clean state reconciliation.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →