Status and Flinks code: Authorize endpoint

Modified on Fri, 30 Jul, 2021 at 3:10 PM

HTTP Status Code	Flinks Code	Description	Message	Steps to Reproduce
200		N/A	The connection was successful.	Complete a successful request.
202	OPERATION_PENDING	The process is ongoing in the background. At this point your flow must change to the async endpoint	Your operation is still processing.	Perform 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.	Your operations had been dispatched to background process for long running jobs	Have a live request to gather GetAccountDetails in more than 210 seconds
400	INVALID_LOGIN	The provided LoginId is invalid	The LoginId provided is either invalid or does not belong to the CustomerId	Call the Authorize endpoint using a non existent LoginId
400	INVALID_LOGIN	The provided username or/and password is/are invalid	The card number (username) or password provided is invalid	Call the Authorize endpoint using non valid credentials
400	INVALID_REQUEST	Credentials are missing/incomplete, or syntax is incorrect (e.g. missing comma)	Message returned will depend on the error (e.g. missing value, incorrect syntax, etc.)	In input, make a typo, remove a comma, etc.
400	SESSION_NONEXISTENT	A request was made with an expired RequestId	Inputs session id or card if were not found.	Use an old RequestId for a new request
400	CARD_IN_USE	An operation was requested while the account is still being processed.		Call the DeleteCard endpoint immediately after Authorizing a new account
401	INVALID_USERNAME	The username provided was different from what the bank expected		Provide an invalid username to an Authorize request
401	INVALID_PASSWORD	The password provided was different from what the bank expected		Provide an invalid password to an Authorize request
401	INVALID_SECURITY_RESPONSE	The MFA response provided was different from what the bank expected		Provide an invalid MFA answer 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		Flinks Capital Username: test_service_unavailable Password: Everyday
401	UNKNOWN_CHALLENGE_KEY	The /Authorize request to respond an MFA contain an answer to the wrong MFA prompt.	"One or more of the Security Challenge Prompts required are missing in the provided response"	Change 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		Open 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	You need to be authorized in the bank account before going further.	Call the GetAccountsDetail endpoint during an MFA prompt without answering the MFA question
401	DISABLED_LOGIN	The account has been deactivated by the financial institution. The account holder must contact their bank		Log into a deactivated account
401	NEW_ACCOUNT	The end user must take action directly on their online banking before connecting and account with Flinks		Login to an account where user must take action on 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		Wait at least 8 minutes before responding to MFA
401	ALREADY_AUTHORIZED	When the /Authorize endpoint is called after the user has already been authorized		Answer an MFA for an already authorized requestid
401	SECURITYRESPONSES_INCOMPLETE	Not all the prompted MFA questions had answers in the reponse request		Not answer all MFA questions prompted in 3 question MFA prompt

** General note: when you received an error code for the cache mode, it means that during the refresh, we faced that error code.