Transient error transient_error
What this decline means
Something in the processing chain hiccuped — Shopify's own description is simply 'try again later.' Nothing is wrong with the customer, the card, or the balance.
Why it happens on subscription renewals
- A timeout or momentary outage between the platform, gateway, and issuing bank.
- The issuer's systems were briefly unavailable or slow to respond, so the attempt gave up.
The merchant playbook
- Retry soon — hours, not days. Transient means transient; most of these clear on the next attempt.
- Say nothing to the customer. They did nothing, they can fix nothing, and a failure email for an infrastructure blip manufactures worry (and support tickets) from thin air.
- Track frequency: transient errors should be rare background noise. A spike concentrated in one hour or one day usually maps to a platform or gateway incident — check status pages before suspecting your setup.
- If the same subscription throws transient errors repeatedly across days, stop calling it transient and look deeper — a persistent 'temporary' failure is usually a different problem wearing the wrong label.
Should you retry?
Yes, promptly. This is the one decline family where a same-day retry is the right move and customer contact is the wrong one.
Common questions
Should transient errors count against my retry limit?
Ideally no — a schedule that burns its three retries on one infrastructure blip has nothing left for the real declines. Tooling that distinguishes error families can retry transient failures outside the main dunning sequence.
The customer got a failure email for a transient error — is that bad?
It's noise at best, trust damage at worst. Where your app allows it, exclude purely technical failures from customer-facing dunning emails.
Related codes: processing_error · generic_error · card_declined · or see the
full decline-code guide.
Where Moorly fits: Moorly reads the decline reason behind every failed renewal in your existing subscription app and applies the playbook above automatically — the right treatment per code, with a dollar figure on what each failure family costs your store. It starts read-only. Join the early-access list →
Moorly is an independent product by Velun Labs and is not affiliated with Shopify, Appstle Inc., or Seal Subscriptions s.r.o. Code names follow Shopify's public API documentation as of August 2026; bank behavior varies by issuer — always confirm against your own admin.