Advanced Integration
We hope you have gone through the FastLink 4 Documentation page that talks about the different FastLink product flows and provides details on how to integrate FastLink for Web.
For more information on errors, see Handling Errors.
Additional Params
You can further configure the FastLink application by passing additional launch parameters to customize the way FastLink application loads. In addition to passing the configName
in the params
object (as explained in the FastLink 4 Documentation page), the following types of additional parameters can be passed:
- Deep-Linking attributes: Pass the attributes to launch FastLink in the desired
flow
. - Callback details: Pass the
callback
URL that has to be called when the flow ends and pass thecallbackLocation
, if thecallback
URL is used in an iFrame integration.
Deep-Linking Attributes
The different deep-linking flows are as follows:
Without calling on a specific deep-linking flow, the FastLink application will start with selecting a site. Click to view the Select a Site screen.
Link Account
- Link account - Start with login form
The FastLink aggregate account scenario allows you to deep-link the application to a specific provider and add all the accounts belonging to it. Pass
flow=add
andproviderId
to start with the site's account authentication screen. Click to view the Verify Credentials screen.Parameter Name Description Example flow Pass add
to invoke the aggregate account flow.... window.fastlink.open({ ... params: { providerId : 16441, flow : 'add', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
providerId The unique identifier for a particular provider (site). groupId The unique group identifier to get the single site experience.
Note: Applies only to UK OB.... window.fastlink.open({ ... params: { groupId : 23235, flow : 'add', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
routingNumber A bank routing number or routing transit number (RTN) is a nine-digit number used in the US to identify a financial institution in a transaction. ... window.fastlink.open({ ... params: { routingNumber : 11103093, flow : 'add', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
- Add Manual Account
The add manual account flow allows you to deep-link the application to the Add Manual Account screen, so that consumers can manually add accounts that the Yodlee aggregation engine does not support. Click to view the Add Manual Account screen.
Parameter Name Description Example flow Pass addManual
to invoke the manual account flow.... window.fastlink.open({ ... params: { flow : 'addManual', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
-
Add Real Estate Account
In the FastLink add real estate account flow, you can deep-link the application to the Add Real Estate Account screen to allow consumers to add the value of their home or property to their profile. Click to view the Add Real Estate Account screen.
Parameter Name Description Example flow Pass addRealEstate
to invoke the add real estate account flow.... window.fastlink.open({ ... params: { flow : 'addRealEstate', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
Edit Account
- Edit account credentials flow
The FastLink edit credentials flow allows you to view the edit credentials screen of an already linked provider account. Click to view the Edit Account Credential screen.
Parameters to deep-link to the edit account view based on the
providerAccountId
follow:Parameter Name Description Example flow The edit
account credentials flow has to be invoked.... window.fastlink.open({ ... params: { providerAccountId : 11799016, flow : 'edit', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
providerAccountId The unique identifier for a particular provider account for which the edit account credentials flow will be invoked. - Edit manual account flow
The FastLink edit manual account flow allows you to view the edit account screen of a manually added account. Parameters to deep-link to the edit manual account view based on the
accountId
follow:Parameter Name Description Example flow Pass editManual
to invoke the edit manual account flow.... window.fastlink.open({ ... params: { accountId : <accountId>, flow : 'editManual', configName : '<config-name-from-config-tool>', container : <container> }, ... }, 'container-fastlink'); ...
accountId The unique identifier for a particular manual account for which the edit account flow will be invoked. container The container of the account for which the edit account flow will be invoked.
Applicable container values:bank
,creditCard
,investment
,insurance
,loan
,reward
,bill
,otherAssets
, andotherLiabilities
. - Edit real estate account flow
The FastLink edit real estate account flow allows you to view the edit account screen of an already added real estate account. Parameters to deep-link to the edit real estate account view based on the
accountId
follow:Parameter Name Description Example flow Pass editRealEstate
to invoke the edit real estate account flow.... window.fastlink.open({ ... params: { accountId : <accountId>, flow : 'editRealEstate', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
accountId The unique identifier for a particular real estate account for which the edit account flow will be invoked.
Refresh Account Flow
The FastLink refresh account flow allows you to initiate the refresh of an already linked provider account and update with the latest data. This flow may prompt for the additional multi-factor authentication (MFA) required by the site during login. Click to view the Refresh Account Login screen.
Parameters to deep-link to the refresh account view follow:
Parameter Name | Description | Example |
---|---|---|
flow | The refresh account flow has to be invoked. |
|
providerAccountId | The unique identifier for a provider account for which the refresh account credentials flow will be invoked. |
Account Balance Refresh
The balance refresh verification flow allows you to verify accounts by performing an on-demand refresh to get the latest account balance. The balance refresh flow can only be invoked when the Verification
config name is passed.
Parameters to deep-link to the balance refresh flow follow:
Open Banking
Multiple Open Banking Application Support
If the customer has multiple OB application, passing the following parameter will launch the particular application:
Parameter Name | Description | Example |
---|---|---|
obAppName | The OB application name that is defined in the FastLink Configuration Tool. |
|
Manage Consent
The consent dashboard or manage consent feature in the UK OB and AU OB lets consumers renew or delete their consent to share account data (for the sites that require the consumer’s consent).
- Consent dashboard – Parameters to deep-link to launch the consent dashboard for UK OB and AU OB follow:
Parameter Name Description Example flow The manageConsent
flow has to be invoked to launch the consent dashboard.... window.fastlink.open({ ... params: { flow : 'manageConsent', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
- Consent details – Parameters to deep-link to the consent details screen of a particular financial institution follows:
Parameter Name Description Example flow The manageConsent
flow has to be invoked to launch the consent dashboard.... window.fastlink.open({ ... params: { providerAccountId : 11799016, flow : 'manageConsent', configName : '<config-name-from-config-tool>' }, ... }, 'container-fastlink'); ...
providerAccountId The unique identifier for the provider account has to be mandatorily passed for which the consent details are displayed.
Consent Notifications – AU OB
The notification screen notifies the consumer if it has been more than 90 days since the consumer has provided consent to the collection and the use of the account data.
Parameter to deep-link to consent notifications follow:
Parameter Name | Description | Example |
---|---|---|
flow | The notifications flow has to be invoked to launch the notifications screen. |
|
Renew Consent – UK OB
A consumer can choose to renew consent if, for example, the selection of accounts has changed at the financial institution site or consent is about to expire at the site and it has to be renewed.
Parameters to launch the renew consent flow follows
Callback Details
The callback details allow you to receive the control from the FastLink application at the end of the flow or when the user exits the application. The parameters to define the callback URL and location follow:
Parameter Name | Description | Example |
---|---|---|
callback | The URL that has to be called at the end of the flow or when the user exits the application. This parameter is not mandatory to pass. |
|
callbackLocation | Pass the key-value pair callbackLocation: 'top' , if the callback URL is used in an iFrame integration and also if the FastLink application is integrated in a different location like an iFrame or a new window. This parameter is not mandatory to pass. |
Post Messages
The FastLink application shares the account addition status with the customer application using the following four callback methods:
The callback/post message attributes follows:
onSuccess(data) Method
The onSuccess(data)
method reports intermediate account addition events to inform the customer that the consumer’s account is successfully added.
{
"fnToCall":"accountStatus",
"providerName":"Dag Site",
"requestId":"COX3l5DppA40dIiJDrkJjmmhVt8=",
"providerAccountId":32132249739,
"status":"SUCCESS",
"providerId":16441,
"additionalStatus":"ACCT_SUMMARY_RECEIVED"
}
onError(data) Method
The onError(data)
method reports intermediate account addition failure event, integration error, and FastLink application launch error.
Events | Post Message Sample Format |
---|---|
Account addition failed message |
|
Application launch Error |
|
For more information, see Handling Errors. |
onClose(data) Method
The onClose(data)
method refers to the action where a consumer has exited or terminated the flow – either abruptly or intentionally, which marks the end of the session.
Following are the possible exit points where an exit post message will be received:
- Clicking or tapping the X or close icon in the header of the FastLink application.
- Clicking or tapping exit points such as Cancel, Save, or Finish buttons in the success screen.
- Clicking or tapping the Close button in the error screen.
- Clicking or tapping the Save & Link More Accounts button in the
add
deep-link flow.
onEvent(data) Method
The onEvent(data)
method is called to notify intermittent status messages to the host application.
Challenge Deposit Verification Entry Point Post Messages
The challenge deposit verification (CDV) or manual verification entry point post messages are as follows:
Events | Post Message Sample Format |
---|---|
User clicks the Enter Account Information button in site selection screen |
|
User clicks the Enter Account Information button in site search screen. |
|
User clicks the Enter Account Information button in login screen. |
|
The search for a specific site is unsuccessful, the user then clicks the Enter Account Information button in site search screen. |
|
User clicks the Enter Account Information button in account summary screen. |
|