Search Overlay

Common API Errors

HTTP Status Code Summary

Code Range Description
2xx Success - indicates that the client’s request was accepted.
4xx Client Error - indicates that the client has made an error with the request.
5xx Server Error - indicates that an error occurred on the server side.

Common HTTP Response Status Codes

Code Description
200 OK Everything worked as expected.
201 Created The request was successful. Paysafe created a new resource and the response body contains the representation.
400 Bad Request This often indicates that a required parameter is missing or that a parameter is invalid. This is a generic client-side error status, used when no other 4xx error code is appropriate.
401 Unauthorized This indicates that the client tried to operate on a protected resource without providing the proper authorization. They may have provided the wrong credentials or none at all.
404 Not Found The requested resource does not exist.
405 Method Not Allowed The client tried to POST or PUT to a resource that would not accept it.
429 Too Many Requests The application is sending too many simultaneous requests.
500 Internal Server Error An error occurred with an internal server.

Bank Account Validation Errors

HTTP Status Code Error Code Description
400 PLAN-SUBSCRIPTION-3 Subscription not modifiable.
400 PLAN-SUBSCRIPTION-1 Plan not modifiable.
409 5284 Plan with provided name already exists.

Common Errors

HTTP Status Code Error Code Description
500 1000 An internal error occurred.
500 1002 An internal error occurred.
500 1003 An internal error occurred.
500 1007 An internal error occurred.
500 1008 An internal error occurred.
429 1200 The API call has been denied as it has exceeded the permissible call rate limit.
401 5000 Your merchant account authentication failed. Either your store ID/ password is invalid or the IP address from which you are sending the transaction has not been authorized.
400 5017 Account disabled.
400 5023 The request is not parseable.
409 5031 The provided reference has already been used for another request.
400 5068 Either you submitted a request that is missing a mandatory field or the value of a field does not match the format expected.
404 5269 The ID(s) specified in the URL do not correspond to the values in the system.
403 5270 The credentials provided with the request do not have permission to access the requested data.
406 5271 You requested a response in the 'Accept' header that is in an unsupported format.
406 5272 The 'Content-Type' you specified in the request header was submitted in an unsupported format.
404 5273 Your client reached our application but we were unable to service your request due to an invalid URL.
401 5275 The authentication credentials provided with the request have expired.
401 5276 The authentication credentials provided with the request have been disabled.
401 5277 The authentication credentials provided with the request have been locked due to multiple authentication failures.
401 5278 The authentication credentials provided with the request were not accepted for an unknown reason.
401 5279 The authentication credentials are invalid.
401 5280 The required authentication credentials were not provided.
405 5281 The request uses an action (for example, GET, POST, or PUT) that is not supported by the resource.