HTTP Response Codes

HTTP Request

MX Merchant uses HTTP response status codes to indicate the success or failure of your API requests. If your request fails, MX Merchant returns an error using the appropriate status code.

In general, there are three status code ranges you can expect:

HTTP Response

Meaning

200 OK

success status response code indicates that the request has succeeded

201 Created

success status response code indicates that the request has succeeded and has led to the creation of a resource

202 Accepted

status code indicates that the request has been accepted for process

204 No Content

success status response code indicates that the request has succeeded,

400 Bad Request

response status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error

401 Unauthorized

client error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.

403 Forbidden

client error status response code indicates that the server understood the request but refuses to authorize it

404 Not Found

standard response code to indicate that communication with a given server was successful, but the server could not find what was requested.

405 Method Not Allowed

response status code indicates that the request method is known by the server but is not supported by the target resource.

406 Not Acceptable

client error response code indicates that the server cannot produce a response matching the list of acceptable values defined in the request's proactive content negotiation headers, and that the server is unwilling to supply a default representation.

422 Unprocessable Entity

response status code indicates that the server understands the content type of the request entity, and the syntax of the request entity is correct, but it was unable to process the contained instructions.

503 Service Unavailable

server error response code indicates that the server is not ready to handle the request.

500 Internal Server Error

The server encountered an error while processing your request and failed.


Did this page help you?