Errors

info

All our API communicates errors through standard HTTP status codes with details supplied in JSON objects. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, the authentication header is missing, etc.), and codes in the 5xx range indicate an error with our servers (these are rare).

The Receive API uses the following error codes:

Error Code	Meaning
400 Bad Request	The request could not be understood by the server due to malformed syntax
401 Unauthorized	The request requires user authentication.
403 Forbidden	The server understood the request, but is refusing to fulfill it.
404 Not Found	The server has not found anything matching the Request-URI.
405 Method Not Allowed	The method specified in the Request-Line is not allowed for the resource identified by the Request-URI.
409 Duplicate Transaction	Transaction with the given number is already in process.
429 Too Many Requests	Request counts exceed our limit. Slow down!
500 Internal Server Error	We had a problem with our server. Try again later.
503 Service Unavailable	We're temporarily offline for maintenance. Please try again later.