3D Secure Errors
JSON error responses from the 3D Secure API include information in the body of the response similar to the following:
{
"error":{
"code":"5016",
"message":"Account not found"
},
"status":"FAILED"
}
{
"error":{
"code":"5068",
"message":"Request validation failed: currency invalid: 'GB' is not a valid ISO 4217 currency code"
},
"status":"FAILED"
}
The error object consists of the following elements:
Element | Type | Required? | Description |
---|---|---|---|
code | string | Yes | The error code. |
message | string | Yes | The error message describing the error. Also shown in the X-Application-Error response header. |
status | enum | Yes | This is the status of the request. |
To save you having to parse the response body to find the error information, you can retrieve the error message from the X-Application-Error response header.
This is a summary of all errors that could be returned when using the 3D Secure API, including HTTP Status Codes.
HTTP Status Code Summary
Code Range | Description |
---|---|
1xx: Informational | Communicates transfer protocol–level information. |
2xx: Success | Indicates that the client’s request was accepted. |
3xx: Redirection | Indicates that the client must take some additional action in order to complete the request. |
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. |
202 Accepted | This indicates that the client’s request will be handled asynchronously. It tells the client that the request appears valid, but it still may have problems once it is processed. |
204 No Content | This is usually returned in response to a PUT, POST, or DELETE request when the REST API declines to send back any status message or representation in the body of the response message. |
304 Not Modified | The client's cached version of the representation is still up to date. |
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. |
402 Payment Required | The parameters were valid but the request failed. |
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. |
415 Unsupported Media Type | The request is in a format not supported by the requested resource for the requested method. |
429 Too Many Requests | The application is sending too many simultaneous requests. |
500 Internal Server Error | An error occurred with an internal server. |
502 External Server Error | We received an invalid response from the upstream gateway in attempting to fulfill the request. |