Skip to main content

Error Handling

In a nutshell

API errors use the same top-level response envelope as successful responses, with status 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.