unknown_error

Error type indicating an unexpected failure that doesn't fit established error categories.

What this means

An unexpected error occurred that the Commerce API couldn't categorize into known error types like invalid_request_parameter or transient_error. These errors represent edge cases, unhandled system states, or failures that require engineering investigation to properly classify. When you encounter an unknown_error, the system has logged comprehensive details for internal analysis, but the error doesn't map to any established failure pattern.

For example, if scheduling a payout fails due to an unforeseen database constraint violation or an unexpected third-party service response, it may surface as an unknown error. The presence of this error type typically indicates the fix code will be contact_customer_support, as resolution requires manual investigation by the engineering team to understand the root cause and potentially reclassify the error for future occurrences.

Example error response

{
  "error": {
    "type": "unknown_error",
    "cause": "unknown",
    "code": "1923",
    "message": "unexpected system error",
    "detail": "An unexpected error occurred while processing your request. Our team has been notified and is investigating.",
    "fix_code": "contact_customer_support",
    "url": "https://commerce.zebo.dev/e/1923"
  }
}

Related errors

• contact_customer_support - Fix code often associated with unknown errors