Error Codes

On this page, you will be able to find information on:

• API error codes
• Errors in the Client Dashboard

API error codes

200 HTTP 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 Status Codes

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 Error Codes

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 Client Dashboard

The following table lists all possible errors that you may receive when using Client 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 Client 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