Error Codes

If an API call cannot reach the Walmart gateway, a basic HTTP error code (such as 503 Service Unavailable) is returned. However, a complete error response object is returned if the gateway is reached.

The table below shows the currently supported error code responses.

  1. The first parameter provides the error description.

  2. The second parameter shows the HTTP status code.

  3. The third parameter specifies the error category.

  4. The fourth parameter specifies the error severity.

  5. The fifth parameter specifies whether the error response includes a field tag.

Error CodeHTTP StatusCategorySeverityField Included
SOME_CONTENT_NOT_FOUND206ApplicationInfofalse
INVALID_REQUEST400DataErrortrue
INVALID_REQUEST_HEADER400DataErrortrue
INVALID_REQUEST_PARAM400DataErrortrue
INVALID_REQUEST_CONTENT400DataErrortrue
MISSING_REQUEST_HEADER400DataErrortrue
MISSING_REQUEST_PARAM400DataErrortrue
MALFORMED_REQUEST_CONTENT400DataErrortrue
UNAUTHORIZED401DataErrorfalse
FORBIDDEN.GMP_GATEWAY_API403DataErrorfalse
CONTENT_NOT_FOUND404ApplicationInfofalse
URI_NOT_FOUND404DataErrorfalse
METHOD_NOT_ALLOWED405DataErrorfalse
INVALID_ACCEPT_TYPE406ApplicationErrorfalse
UNSUPPORTED_MEDIA_TYPE415DataErrorfalse
RESOURCE_IS_LOCKED.GMP_RECEIVER_API423ApplicationErrorfalse
REQUEST_THRESHOLD_VIOLATED429RequestErrorfalse
INVALID_SYSTEM_STATE500SystemErrorfalse
SYSTEM_ERROR500SystemErrorfalse
DOWNSTREAM_SYSTEM_TIME_OUT504SystemErrorfalse

For example, the last error object on the right contains an INVALID_REQUEST_HEADER error encountered when invoking the GMP_ORDER_API. The error is a DATA ERROR in the WM_QOS. The CORRELATION_ID field (a request header) is null or blank.