- API error codes
- Errors in the Dashboard
API error codes
- 200 HTTP Codes
- 400 HTTP Status Codes
- 500 HTTP Error Codes
200 HTTP Codes
| HTTPS STATUS CODE | FLINKS CODE | DESCRIPTION |
|---|---|---|
| 200 | OK | Settings applied; returns the updated resource. Reproduced by completing a successful request. |
| 201 | CREATED | The request has been fulfilled and a new resource has been created. Reproduced by completing a successful request. |
| 202 | OPERATION_PENDING | The process is ongoing in the background. At this point your flow must change to the async endpoint. Reproduced by performing a cached flow immediately after Authorizing a new account. |
| 202 | OPERATION_DISPATCHED | Your sync request took more than 210 seconds and it was dispatched in the background. Reproduced by having a live request to gather GetAccountDetails in more than 210 seconds. |
400 HTTP Codes
| HTTP STATUS CODE | FLINKS CODE | DESCRIPTION |
|---|---|---|
| 400 | SESSION_NONEXISTENT | A request was made with an expired RequestId. Reproduced by using an old RequestId for a new request. |
| 400 | CARD_IN_USE | An operation was requested while the account is still being processed. Reproduced by calling the DeleteCard endpoint immediately after Authorizing a new account. |
| 401 | ACCESS_DENIED | Authentication was unsuccessful. Reproduced by calling the Authorize endpoint without having valid authentication credentials. |
| 401 | INVALID_LOGIN | The provided LoginId is invalid. Reproduced by calling the Authorize endpoint using a non existent LoginId. |
| 401 | INVALID_LOGIN | The provided username or/and password is/are invalid. Reproduced by calling the Authorize endpoint using non valid credentials. |
| 401 | INVALID_REQUEST | Credentials are missing/incomplete, or syntax is incorrect (e.g. missing comma). Also occurs when request source is unsupported due to URL formatting errors (double slash //v3 instead of /v3) or missing required headers. Reproduced by making a typo, removing a comma, or incorrect URL formatting. |
| 401 | INVALID_SECURITY_RESPONSE | The user has provided incorrect or incomplete MFA answers and cannot retry. Reproduced by providing an invalid MFA answer to an Authorize request. |
| 401 | INVALID_USERNAME | The username provided was different from what the bank expected. Reproduced by providing an invalid username to an Authorize request. |
| 401 | INVALID_PASSWORD | The password provided was different from what the bank expected. Reproduced by providing an invalid password to an Authorize request. |
| 401 | QUESTION_NOT_FOUND | The MFA prompt doesn’t have a stored answer. |
| 401 | RETRY_LATER | Flinks was not able to open a connection with the selected financial institution. Reproduced by making an authorize with the following credentials to Flinks Capital: Username: test_service_unavailable Password: Everyday. |
| 401 | TOO_MANY_REQUESTS | The endpoint has received too many requests in a given amount of time. |
| 401 | UNKNOWN_CHALLENGE_KEY | The /Authorize request to respond an MFA contain an answer to the wrong MFA prompt. Reproduced by changing the MFA prompted, or leave the MFA prompt blank in the input Change the MFA response or leave the MFA response blank. |
| 401 | CONCURRENT_SESSION | Another session is already opened with this LoginId. Reproduced by opening two requests simultaneously with the same account. |
| 401 | UNAUTHORIZED | The card was not authorized. Either there is a problem with bank, or the GetAccountsDetail endpoint was called before authorized. Reproduced by calling the GetAccountsDetail endpoint during an MFA prompt without answering the MFA question. |
| 401 | UNHANDLED | An error was encountered that cannot be handled or processed. |
| 401 | DISABLED_LOGIN | The account has been deactivated by the financial institution. The account holder must contact their bank. Reproduced by logging into a deactivated account. |
| 401 | NEW_ACCOUNT | The end user must take action directly on their online banking before connecting an account with Flinks. Reproduced by logging in to an account where the user must take action on the bank’s website (e.g. to accept a consent form). |
| 401 | SESSION_EXPIRED | The RequestId expired after 8 mins of inactivity during Authorize or 30 mins timeout for data processing. |
| 401 | ALREADY_AUTHORIZED | When the /Authorize endpoint is called after the user has already been authorized. Reproduced by answering an MFA for an already authorized RequestId. |
| 401 | SECURITYRESPONSES_INCOMPLETE | Not all the prompted MFA questions had answers in the response request. |
| 404 | NO_TRANSACTION | The account does not have any transactions. Reproduced by performing an Attributes request for an account with no GetAccountsDetails previously processed. |
| 405 | DISABLED_INSTITUTION | The selected financial institution is not available. |
500 HTTP Codes
| HTTP STATUS CODE | FLINKS CODE | DESCRIPTION |
|---|---|---|
| 500 | AGGREGATION_ERROR | Flinks had an unexpected error and could not process your request. |
| 501 | METHOD_NOT_AVAILABLE | The requested API is not currently enabled in your instance. Kindly contact us if you wish to use this feature. |
Errors in the Dashboard
The following table lists all possible errors that you may receive when using Dashboard.| STATUS CODE | STATUS CODE | DESCRIPTION |
|---|---|---|
| 203 | Answering Security Challenge | The user is answering the security questions. |
| 200 | Partially Completed | Account summary was completed. We are still processing the account details. |
| 401 | Session Expired | The user’s session expired. |
| 200 | Completed | The request was completed successfully. |
| 401 | Invalid Password | The request was completed successfully. |
| 401 | Invalid Username | The user entered an invalid username. |
| N/A | Not Completed | The request was not completed. |
| 401 | Invalid Login | The credentials the user provided were incorrect. |
| 401 | New Account | The user needs to perform an action on the online banking site and try again later. |
| 401 | Disabled Login | The user account is locked out. The user needs to reset his password directly on the online banking website. |
| 401 | Retry Later | After several attempts, we were unable to log into the user account. The user needs to try again later. |
| 401 | Invalid Security Response | The security answer(s) the user entered are invalid. |
| 401 | Unknown Challenge Key | One or more of the Security Challenge Prompts required are missing in the provided response. |
| 401 | Unauthorized | The institution did not authorize the access of the summary page. |
| 202 | Operation Pending | The operation is still processing. |
| 202 | Operation Dispatched | The operation has been dispatched and will be processed soon. |
| 200 | Get Statements Complete | We successfully fetched the PDF statements. |
| 200 | Scoring Insight Completed | We successfully generated the score. |
| 400 | Session Nonexistent | The session does not exist. |
| 401 | Concurrent Session | Two or more sessions were triggered at the same time. |
| 200 | Get Details Complete Statements Still Processing | Account details was completed. We are still processing the statements. |
| 401 | Bank Maintenance Retry Later | The institution was under maintenance. The user needs to try again later. |
| 200 | Ocr Files Uploaded | Files was uploaded successfully. We are processing the statements. |
| 200 | Ocr Integration Started | Files was uploaded successfully. We are processing the statements. |
| N/A | Ocr Files Integration Failure | One or more files uploaded are rejected or not supported. Click on the request for more details. |
| N/A | Ocr Completed With Partial Error | One or more files uploaded are rejected or not supported. Click on the request for more details. |
Warnings in the Dashboard
The following warning messages display when a connection is successful, but certain information is missing.| WARNING | DESCRIPTION |
|---|---|
NoAccounts | We’re not able to extract the account |
NoHolder | We’re not able to see the name of the account holder |
KycIncomplete | KYC information is incomplete |
NoAddress | We’re not able to see the address that’s associated with this account |
AddressIncomplete | The address that’s associated with the account is missing or incomplete |
AccountIbvIncomplete | Some accounts with IBV (instant bank verification) are incomplete |
TransactionIncomplete | Some transactions are missing details |
TransactionNull | The account has no transactions that are associated with it |
AccountNumberIncomplete | Some account numbers are missing or incomplete |
TransactionsWrongOrder | The transactions are in the wrong order |
AccountWithoutUrl | The account URL is missing from the account details |
AccountDuplicate | The account number is a duplicate |
TransactionDuplicate | The transaction is a duplicate |
ValidateCurrency | The balance is not a valid value for an amount in this currency |
MissingOperationAccounts | We’re missing the operations account |
NoTransactions | We’re not seeing a transaction on the account |
AccountIbvUnavailable | IBV is unavailable for the account |
HolderIbvUnavailable | IBV is unavailable for the account holder |
MissingStatementsPDF | Some accounts are missing PDF statements |
InvalidEmail | The KYC email is invalid |
NoLastMonthTransaction | Some accounts had no transactions last month |
PciNonCompliantCardNumber | PCI Non-Compliant card number |
DesjardinsMissingConsent | Missing consent for Desjardins |
TransactionsMisconfigured | Transactions for this account should not exist because the client used WithTransactions:false |
WindowInUse | The same browser window is being requested by two different requestIds |
NoLast15DaysTransaction | We were not able to locate any transactions within the past 15 days |
MFAAfterAuthorization | Certain financial institutions require additional MFA steps after authentication |
ProductDetailsMissing | Client has requested product details but we are unable to return any |
ProductDetailsIncomplete | Client has requested product details but we are only able to return partial data |
BalanceMismatch | The balance in the account summary is different in the balance that’s showing at the end of the last transaction on the account |