4xx
Correct input, authentication or rights; blind retry does not change the problem.
Developer Center · Reliability
Treat errors predictably.
Not every mistake deserves the same reaction. Correct permanent request problems, slow down at rate limits and use only limited retries in case of temporary malfunctions.
429
Respect backoff, reduce request pressure and prevent multiple workers from exacerbating the problem.
5xx & timeouts
Use limited retries with jitter and a usable fallback for storefront traffic.
Logging
Store request context, store, status and error without logging secrets or unnecessary sensitive data.
Security →