An online tool to configure your integration with flanks
The Flanks Platform is an online tool which enables you to interact with our API in a friendly way.
Once logged in, you can create apps and upload your CSS configuration for the Flanks Link.
Shortly after your signup, you will receive a confirmation email with a link to verify your account:
From this panel, you will be able to manage all your apps.
Clicking on Create app will show a modal; after giving it a name, your app will be ready. You can now use its
From an app tile, click on View to manage it. In addition to the credentials, you can also add several callback URLs and create a link for your clients.
An app link is a fast, easy way to allow your users to authenticate with the Financial institution throught Flanks platform. You can create them from an app.
A link provides a fast and secure authentication flow which enables your end users to authenticate with their banking platforms. You can easily integrate a link into your applications and start retrieving your end users' financial data. Links are unique and static so they can be reused for all your clients. You might create different links for different your different environments (development, production).
From your app settings page, you can manage its redirect URIs. Since a link must use a redirect URI, you have to create one first.
Click on the blue box to add a new redirect URI.
Enter a well-formed URI and save.
You can add as many redirect URIs as you desire.
You can also delete existing redirect URIs by clicking on Delete.
Click on the red box to confirm delete.
After the user has introduced their online banking credentials and Flanks system has verified their are correct the user will be redirected to the redirect URI associated to the link used by the user.
Click on Generate link and select one of the app redirect URIs. Your link will be generated:
Select a redirect URI.
After generating a link, any client can use it to introduce credentials in order to authenticate against their banking platform.
After a successful login, the end user will be redirected to the redirect URI specified when creating the link. A
codequerystring parameter will be appended to the redirect URI:
Now you can recover the
codeparameter from the querystring.
In some cases, your redirect URI will look like this:
delayed=trueindicates that several security checks are performed before you can obtain your final token. Don't worry, it doesn't last more than 72h.
The final step is to exchange this
credentials_token, which can be done via the EXCHANGE LINK CODE FOR CREDENTIALS TOKEN endpoint. The code is one-use, so ensure you properly save the resulting
The process will be finished and a
credentials_tokenwill be added to your Users panel.
The EXCHANGE LINK CODE FOR CREDENTIALS TOKEN will return all your additional parameters under the
extraattribute. Then, you can use those parameters to identify to which client does the
credentials_tokencreated from a link will appear here.
You can now use those
credentials_tokento retrieve all financial data.
When a bank ask for two-factor authentication, in every login or every given number of days, the login access must be reauthorized. This flow requires user interaction again.
You must redirect your client to a URL resembling to this one
- sca_token: is the value returned by /credentials/status enpoint
- bank: it is the id field of the /banks/available endpoint matching to the credentials_token
You can also pass extra query parameters as explained in Using links to connect to banks. When users are redirected to this URL, Flanks will ask them only for the value of the SCA. After introducen the value and if everything goes right, Flanks will redirect your user to the configured redirect_uri of your App with a code querystring added. This code should be used as exchange for the credentials_token and extra parameters in order you can identify your client.
*The credentials_token will not change.
Custom CSS icon
Inside this page, drag and drop or browse your files in order to upload the custom CSS file:
Custom CSS section
Here you have an example CSS file. Our link elements have an ID so that it's easiler to style them, for this reason we recommend you to use these ID's when creating the custom style.
color: #78281f !important
background: #fadbd9 !important
Then, you have to generate a link if you don't have one, in order to access the popup with your custom style. This style will be applied in all the applications created.
Custom styled popup
You can restore the default theme at any time. For that purpose, go to the Custom CSS section and click on the right button Restore default theme: