Connect Web 1.0 embed iFrame

We recommend all Finicity clients Migrate to Connect Web SDK 2.0. Connect Web 1.0 will retire effective June 1, 2021.

Step 1—Generate a Connect URL link

Step 2—Add the library script tag

The Connect Web SDK is a Finicity JavaScript tag that access’ the SDK library. Add this tag anywhere you want to your web application.

 <script src=""></script> 

Step 3—Open the Connect iFrame

After the library is loaded in your application, open the Connect iFrame using the URL you received when you generated a connect URL link.

Connect iFrame - sample code

This is an example of how to embed Finicity Connect 1.0 into an iFrame.

 // Frontend Javascript running on web app
method: 'POST',
body: JSON.stringify(customerData)
}).then(function(response) {
const customerId = response.customerId;
const consumerId = response.consumerId;
const finicityConnectUrl = response.finicityConnectUrl;
window.finicityConnect.connectIFrame(finicityConnectUrl, {
selector: '#connect-container',
overlay: 'rgba(255,255,255, 0)',
success: function(data) {
console.log('Yay! We got data', data);
cancel: function() {
console.log('The user cancelled the iframe');
error: function(err) {
console.error('Some runtime error was generated during Finicity
Connect', err);
loaded: function() {
console.log('This gets called only once after the iframe has
finished loading');
route: function(event) {
console.log('This is called as the user progresses through

Additional Properties Definitions

  • The selector and overlay properties (optional) allow additional customization.

  • The selector property allows you to select an HTML element to bind the iFrame.

  • The iFrame is contained within the element and doesn’t expand, filling the entire page.

  • The overlay property allows you to select the color of the background overlay that fills the space if the display is larger than the widget.

Manually remove a Connect 1.0 iFrame

The SDK provides a destroyIFrame method which removes the Connect iFrame from the Document Object Model (DOM).