authorization_failed

Error cause indicating credentials were authenticated successfully but lack permission to perform the requested operation.

What this means

Your API key is valid and the Commerce API successfully authenticated you, but your credentials don't have the necessary permissions to access the requested resource or perform the requested operation. This typically occurs when you attempt to access a resource that belongs to a different application or when your API key's scope doesn't include the operation you're attempting. For example, trying to pay for an order that exists but belongs to another application will result in authorization failure—your identity is verified, but you're not authorized to operate on that specific order.

Similarly, if you attempt to access an endpoint that requires elevated permissions your API key doesn't possess, you'll encounter this error. This cause results in an HTTP 403 status code and indicates a permanent failure that requires either using the correct API key for the resource or contacting support to adjust your application's permissions.

Example error response

{
  "error": {
    "type": "bad_request",
    "cause": "authorization_failed",
    "code": "1403",
    "message": "authorization failed",
    "detail": "You do not have permission to access this resource. The resource may belong to a different application or your API key lacks the required permissions.",
    "fix_code": "change_request_parameters",
    "url": "https://commerce.zebo.dev/e/1403"
  }
}

Related errors

• authentication_failed - Invalid credentials
• contact_customer_support - May need support for permission issues