Error Handling
In a nutshell
API errors use the same top-level response envelope as successful responses, withstatus set to error.
Error shape
Common status codes
Examples
Handling guidance
- Treat non-2xx responses as failed requests.
- Surface validation messages in logs or dashboards.
- Retry network errors with care.
- Do not retry payment failures blindly.
