1. Complete our Google Form to tell us about your setup.

  2. Install Flinks Connect. For more information, see Configure and Install Flinks Connect.

  3. Update the redirectUrl to your own URL. 

  4. After the user is successfully connected, Flinks appends the loginId to the URL. Set up your application to save this loginId. For more information, see the following example: 

https://www.example.com/flinks/connection/?loginId=******

  1. Listen to Javascript events by pasting the following script into the <body> section of your site:


<!-- Event Listener -->

<script>

  window.addEventListener('message', function(e) {

    console.log(e.data);

  });

</script>


Optional: Add the parameter webview=true to the Flinks Connect URL. Flinks Connect will emit events directly to the ReactNativeWebView.


  1. Insert the following css rules into a <style> tag or inside an external css file. This ensures that the iframe is placed in the correct position on the page:

        

    .flinksconnect {

  width: 100%;

  height: 700px;

}    


  1. Insert the following code into the <body> section of your site, then update the demo URL with the URL that you want Flinks Connect to call. For more information, see the following example:


<!-- Flinks Connect →

<iframe class="flinksconnect"

src="https://demo-iframe.private.fin.ag/v2/?webview=true">

</iframe>


  1. Allow popups in React Native WebView by setting the following parameters on the webview:

    1. javaScriptEnabled to TRUE

    2. javaScriptCanOpenWindowsAutomatically to TRUE

  2. Configure your app to support deepLink based on your redirectUrl
    https://reactnative.dev/docs/linking 

  3. To enable testing, add ?demo=true to the demo URL:

src="https://demo-iframe.private.fin.ag/v2/?webview=true&demo=true">

This enables Flinks Capital, which you can use to test with our test users. For more information on how to test Flinks Connect using our test users, see Test Institution.


  1. Confirm there is successful one-way communication between the iframe and your app. For more information about what Flinks Connect emits to your app, see the following example:


{step: 'APP_MOUNTED'}

2{step: 'COMPONENT_LOAD_INSTITUTION_SELECTOR', cached: false}

3{step: 'INSTITUTION_SELECTED', institution: 'FlinksCapital'}

4{step: 'COMPONENT_LOAD_CREDENTIAL', institution: 'FlinksCapital'}

5{step: 'SUBMIT_CREDENTIAL', institution: 'FlinksCapital'}

6{step: 'COMPONENT_LOAD_MFA', mfaTypes: Array(1), institution: 'FlinksCapital'}

7{step: 'SUBMIT_MFA', institution: 'FlinksCapital'}

8{step: 'REDIRECT', loginId: '******', requestId: '******', institution: 'FlinksCapital'}