FinGoal Fastlink API
The Link Money API permits end users to link and get data from their bank accounts. But of course, that requires a front-end interface. That's where the Fastlink comes in. The Fastlink is an example of what we call a "Linking Widget" - a small application, usually embedded via iframe in another financial application, that allows end users to interact with an aggregation service - in this case, Yodlee's Fastlink. In this documentation `Fastlink` refers specifically to `Fastlink 4`, which is the most recent version of Yodlee's Fastlink widget. We do not support older versions of Fastlink, and urge all of our onboarding customers to upgrade to Fastlink 4. To open a frontend session with Link Money's Fastlink4, you must: - Have a client registered with the Link Money API - Have client credentials for the Link Money API - Have a single registered user with the Link Money API - Have a web application (or test web application) with HTML and JavaScript where the FL4 can be embedded. ### Step 1: Get an authentication token First, get an authentication token for Link Money. ```js const fetch = require('node-fetch'); // If using Node.js, ensure to install the 'node-fetch' package // Client credentials and other required information. We recommend storing these in a secure location, such as a password vault. const clientId = 'YOUR_CLIENT_ID'; const clientSecret = 'YOUR_CLIENT_SECRET'; // The URL to your authentication endpoint const tokenUrl = '{LINK_MONEY_BASE_URL}/oauth/token'; // Prepare the request body const requestBody = { clientId, clientSecret }; // Make the HTTP POST request to obtain the JWT try { const rawResponse = await fetch(tokenUrl, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: requestBody }); const data = await response.json(); const token = data.accessToken; // Use the access token for subsequent API requests that require authentication } catch(error) { console.error('Error fetching the access token:', error); } ``` ### Step 2: Get the Fastlink configuration With the `token` from the request, you can authorize a call to the Fastlink widget endpoint. ```js const fetch = require('node-fetch'); // If using Node.js, ensure to install the 'node-fetch' package const accessToken = "{YOUR_ACCESS_TOKEN}"; // see previous step. const getFastlinkConfigUrl = '{LINK_MONEY_BASE_URL}/yodlee/fastlink'; const login_name = `any_string_of_your_choice`; try { const rawResponse = await fetch(getFastlinkConfigUrl, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${accessToken}` }, body: { login_name } }); const data = await response.json(); const { fastlinkConfiguration } = data; const { accessToken, fastLinkURL, configName } = fastlinkConfiguration; // Use the accessToken, fastLinkURL, and configName to embed the Fastlink widget in your application } catch(error) { console.error('Error fetching the access token:', error); } ``` ### Step 3: Embed the Fastlink widget The fields provided above have supplied you with everything you need to open the Yodlee Fastlink widget in your application. To complete the integration, you will need to use the Yodlee Fastlink SDK along with the configuration provided above. ```html ``` ### Step 4: Additional Configuration The Fastlink widget can be configured to meet your specific needs. For more information on configuration options, see the [Yodlee Fastlink 4 documentation](https://developer.envestnet.com/resources/yodlee/fastlink-4/docs/documentation). The Link Money API surfaces the variables required to open any instance of Fastlink 4. However, we do not currently surface any helper functions for customized instances of Fastlink4. However, we also do not restrict you from customizing the Fastlink widget to meet your needs. If you are opening the FL4 for a specific provider, simply alter the base configuration above as you normally would.