stripe "issuer_not_available" on subscription renewal: acquirer timeout, retry later
Explains Stripe issuer_not_available declines on subscription renewals: the card network or issuer timed out, a transient communication failure. Use when renewal invoices fail with this code. Not for permanent declines like do_not_honor or insufficient_funds.
TL;DR
issuernotavailable is a timeout between the acquirer and the issuer, a transient blip, not a rejection. The right move is a scheduled retry: put the invoice back in the retry queue and let Stripe Smart Retries or your own retry schedule try again. The card itself is almost certainly fine.
issuer_not_availableUse this when
- A subscription renewal invoice fails with decline code issuernotavailable.
- The same card succeeded before, so a sudden permanent decline is unlikely.
- You are tuning dunning or Smart Retries behavior for transient failures.
Not for this skill when
- The decline is donothonor, insufficientfunds, or lostcard. Those need customer action.
- This is the first payment on a new card. Check the card details instead of assuming a blip.
Steps
- ('Confirm the decline code is issuernotavailable and the invoice is in retryable state. Verify: no customer action is pending on the invoice.', 'Leave the invoice in the retry flow; do not cancel or void it. Verify: the subscription stays active or past_due as configured, not canceled.', 'If you run your own retries, schedule the next attempt 12-24 hours out, not minutes. Verify: backoff is set so you do not hammer a timing-out network.', 'Notify the customer only if retries keep failing; a single blip needs no email. Verify: no dunning email fired for a transient timeout.', 'If it repeats across many customers at once, check the Stripe status page for network issues. Verify: your account shows no processor incident.')
Variant phrasings
stripe issuernotavailable retry
The standard follow-up question.
issuernotavailable stripe meaning
Docs-style search.
stripe subscription renewal timeout issuer
Symptom phrasing.
Compatibility: Stripe Payments and Billing. issuernotavailable is a network-level decline code on charges and payment intents.
Why it happens
Card authorization is a live network conversation: acquirer asks the issuer over the card network. issuernotavailable means that conversation timed out, the issuer never answered. It is infrastructure, not judgment. It spikes during issuer maintenance windows and network congestion, and it clears when the network does, which is why waiting and retrying is the correct fix.
Edge cases / pitfalls
- Do not email the customer "your card was declined" for one issuernotavailable. It was not.
- Aggressive same-day retries on a timing-out issuer waste attempts and look like card testing.
- If a single card hits issuernotavailable repeatedly across days, treat it as a real problem and ask the customer to check with their bank.
- Make sure Smart Retries is enabled; manual dunning often treats every decline the same.
Provenance
Resolved from the public thread: https://vectle.com/posts/pst_Mys61RYmZij1lyXaN-qOAQ