Troubleshooting the API
A brief summary of the most common error codes and how to deal with them
While developing your solutions using Flanks API, the following error codes may be returned by several endpoints. This reference aims to provide insight about the underlying errors and their common causes.
Error codes
The following codes defined provide extra information of possible errors. They are returned at the JSON response among the other fields depending of the endpoint called.
ERROR NAME | ERROR CODE | CAUSE | ACTION |
---|---|---|---|
INCOMPLETE | 20001 |
| Open a ticket and our support team will be happy to help you. |
PROCESSING | 20002 |
| Wait until the data you are asking for has been retrieved. You can poll the |
SCA_ERROR | 20003 |
| This error can be only if you are a regulated entity and you are not using the Flanks Link to connect credentials. |
CONFIGURATION_ERROR | 40001 |
| Review the request headers, query parameters and or body content. |
BANK_ERROR | 50001 |
| This error can be only if you are a regulated entity and you are not using the Flanks Link to connect credentials.The website of the bank is not available, you should try later. |
CREDENTIALS_ERROR | 50002 |
| This error can be only if you are a regulated entity and you are not using the Flanks Link to connect credentials. You can review the introduced credentials and try again. |
SCA_REQUIRED | 50003 |
| This error can be only if you are a regulated entity and you are not using the Flanks Link to connect credentials. You need to ask your user to the 2FA in order to finish the connection of credentials. |
Successful responses
200 OK
The requested operation was completed successfully.
These responses may contain a brief message
indicating the operation performed and its result.
For example, when creating a credentials_token
, a successful response would be:
202 ACCEPTED
Token delayed during security checks.
When retrieving a credentials_token
from a Link code, you may receive this response. This means the operation was successfully completed and Flanks is performing several security checks.
Error responses
400 BAD REQUEST
Missing fields
The query payload is missing one or more of the required parameters or fields.
The error message will provide information about which fields are missing:
Invalid parameter
A provided parameter was invalid.
The error message follows this schema:
Invalid parameter: an element does not exist
An element identified by a provided parameter does not exist.
For instance, while retrieving an Application by name, the error message would be similar to:
Retrieving user data
The process of data retrieval has not finished yet.
Please wait a moment.
Data is not available
Some error has occurred retrieving data.
You can see which data field is errored with credentials/status request.
Our system will notify us but you can contact support@flanks.io if the error persists.
Data quality and security check in process
Randomly the system selects a credentials_token (when it is created) and our team verifies data quality.
401 UNAUTHORIZED
Invalid credentials
The provided authentication credentials were invalid.
The message follows this schema:
Or:
405 METHOD NOT ALLOWED
Endpoint with invalid method
You are trying to access an endpoint with an invalid HTTP method. Check the API Docs and try again.
409 CONFLICT
An element already exists
You are trying to create an element which already exists.
For instance, when creating an Application with an already existing name, the error message would be similar to:
415 UNSUPPORTED MEDIA TYPE
The provided payload does not comply with the expected content type.
This error message indicates that the endpoint received data with an invalid format.
Check that the Content-Type
header is set accordingly. Generally, it is application/json
.
When uploading files, check that the Content-Type
header is set to multipart/form-data
. This error may also arise when the file content does not match the file extension; for instance, when uploading a XML file with a .pdf
extension.
500 INTERNAL SERVER ERROR
Server error
This is an internal error. The error message will provide as much information as possible to ease troubleshooting.
Fields
If any field of a response could not be retrieved from the entity or calculated afterwards it's value will be set to null
.
Last updated