Error Codes

Alviere employs standardized HTTP response codes to convey the outcome of API requests. Each response code provides insights into whether a request was successful, requires redirection, has client-induced errors, or encountered server-side issues.

Categories of HTTP Response Codes:

• 2xx (Success): The request was processed successfully and contains no errors.

• 3xx (Redirection): Additional actions are needed to finalize the request.

• 4xx (Client Error): The request contains inaccuracies, often stemming from the client side.

• 5xx (Server Error): These indicate issues within our infrastructure and are uncommon.

  • Urgent Action Required: Should you encounter any 5xx errors, please reach out to us without delay at ops@alviere.com.

Common HTTP error codes

API error codes

In addition to the status code, some response bodies will also contain a Validation section, indicating the specific outcome of your request. This encompasses:

• Result: Specifies if the request was "Accepted" or "Denied".

• Error code: A unique identifier linked to a recognisable request error.

• Description: Elaborates on the particular error encountered.

If the request has no issues, these fields remain unpopulated.

Sample response

{
  "validation": {
    "result": "REJECTED",
    "error_code": "500012",
    "error_description": "Payment method is invalid"
  }
}

List of error codes (HTTP 400 responses)