Sorry, you need to enable JavaScript to visit this website.
Skip to main content

FastLink Upgrade Post Messages

Important Changes

Before we get into each post message, we must understand a few high-level changes that impacted the post messages.

Platform Name Changes

Field name changes to be aware of while upgrading to Yodlee API v1.1 are as follows:

Legacy API Field Names Yodlee Core API v1.1 Field Names
memSiteAccount providerAccount
memSiteAccId providerAccountId
Site provider
itemAccountId accountId
itemAccounts accounts

Additionally, following are field names changed in FastLink post messages:

Legacy Field Name New Field Name
siteAccountId providerAccountId
statusCode additionalStatus
bankName providerName
siteName providerName

Deprecated Platform Fields

For the list of deprecated fields, refer to the Deprecated Fields on our Upgrade Guide page.

The following legacy field names have also been deprecated in FastLink post messages:

  • code
  • transferAccountId
  • accountVerificationDataId

Error Code to Additional Status Mappings

For mapping of numeric error code to additional status enums, refer to the Error Code to Dataset Additional Status Mappings on our Upgrade Guide page.

Resize Event

Your version could be using either newThemeResizeFloater or resizeFloater for fnToCall. This does not apply to customers using Initialize JS library.

FastLink (Legacy) FastLink 4 
{
   "fnToCall":"newThemeResizeFloater/resizeFloater",
   "finappId":"10003600",
   "height":500,
   "skipScrollForResizeFloater":false
}

{
   "fnToCall":"resizeIframeWindow",
   "app":"fastlink",
   "height":500
}

Error Events [onError(data)]

This list below accounts for all nodes across multiple legacy versions of FastLink, so you may or may only be using some. Please select whichever applies to your implementation. Example: siteName vs. bankName.

Account Addition Failed Message

FastLink (Legacy) FastLink 4 
{
   "fnToCall":"accountStatus",
   "providerId":16441,
   "siteName":"Dag Site",
   "bankName":"Dag Site",
   "requestId":"rsglj0CIMoQsopKQrNLE4fz7nzE=",
   "reason":"Hmm. Did your Dag Site login or password change? Double-check and re-enter the most current login information you have.",
   "status":"FAILED/ERROR",
   "errorCode":406,
   "statusCode":"USER_ACTION_NEEDED_AT_SITE",
   "siteAccountId":11350520,
   "providerAccountId":11350520
}

{
   "providerId":16441,
   "providerName":"Dag Site",
   "requestId":"rsglj0CIMoQsopKQrNLE4fz7nzE=",
   "reason":"Please visit Dag Site to update your account information or password.",
   "status":"FAILED",
   "additionalStatus":"USER_ACTION_NEEDED_AT_SITE",
   "providerAccountId":11350520
}

Application Launch Error

FastLink (Legacy) FastLink 4 
{
   "errorCode":1010,
   "errorSummary":"{error_summary}",
   "errorDescription":"{error_description}",
   "fnToCall":"ssoErrorHandle",
   "redirectUrl":"{sso_redirect_url}"
}

{
   "code":"NXXX",
   "title":"{error_title_NXX}",
   "message":"{error_description_NXX}",
   "fnToCall":"errorHandler",
   "redirectUrl":"{sso_redirect_url}"
}

Integration Error

FastLink (Legacy) FastLink 4 
{
   "status":"FAILED",
   "reason":"We're sorry, it appears to be an invalid site detail. Please try again with valid site details.",
   "fnToCall":"accountStatus",
   "bankName":"",
   "providerAccountId":"12345678",
   "providerId":""
}

{
   "code":"E701",
   "title":"INVALID_PARAMETER_OR_VALUE",
   "message":"Invalid value for providerId",
   "fnToCall":"errorHandler"
}

Success Events [onSuccess(data)]

FastLink (Legacy) FastLink 4 
{
   "fnToCall":"accountStatus",
   "bankName":"Dag Site",
   "requestId":"COX3l5DppA40dIiJDrkJjmmhVt8=",
   "providerAccountId":32132249739,
   "status":"SUCCESS",
   "reason":"Success",
   "providerId":16441,
   "additionalStatus":"ACCT_SUMMARY_RECEIVED",
   "code":0
}

{
   "fnToCall":"accountStatus",
   "providerName":"Dag Site",
   "requestId":"COX3l5DppA40dIiJDrkJjmmhVt8=",
   "providerAccountId":32132249739,
   "status":"SUCCESS",
   "providerId":16441,
   "additionalStatus":"ACCT_SUMMARY_RECEIVED"
}

Close Events [onClose(data)]

Aggregation

FastLink (Legacy) FastLink 4 
{
   "action":"exit",
   "fnToCall":"accountStatus",
   "sites":[
      {
         "providerId":5,
         "bankName":"Wells Fargo",
         "requestId":"vNHnOZ05sXZF1gFzEpF9BoMlSt0=",
         "status":"SUCCESS/2",
         "statusCode":"AVAILABLE_DATA_RETRIEVED",
         "providerAccountId":11333937
      }
   ]
}

{
   "action":"exit",
   "fnToCall":"accountStatus",
   "sites":[
      {
         "providerId":5,
         "providerName":"Wells Fargo",
         "requestId":"vNHnOZ05sXZF1gFzEpF9BoMlSt0=",
         "status":"SUCCESS",
         "additionalStatus":"AVAILABLE_DATA_RETRIEVED",
         "providerAccountId":11333937
      }
   ]
}

Verification (Success)

FastLink (Legacy) FastLink 4 
{
  "action": "exit",
  "fnToCall": "accountStatus",
  "status": "VERIFICATION_SUCCESS",
  "reason": "VERIFICATION_SUCCESS",
  "itemAccountId": 134539937,
  "providerAccountId": 11333937,
  "code": 0,
  "itemId": 20712356,
  "transferAccountId": 11313956,
  "accountVerificationDataId": 11020016,
  "sites": [
    {
      "providerId": 5,
      "bankName": "Wells Fargo",
      "requestId": "vNHnOZ05sXZF1gFzEpF9BoMlSt0=",
      "status": "SUCCESS",
      "statusCode": "AVAILABLE_DATA_RETRIEVED",
      "accountId": 134539937,
      "providerAccountId": 11333937
    }
  ]
}

{
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 5,
      "providerName": "Wells Fargo",
      "requestId": "vNHnOZ05sXZF1gFzEpF9BoMlSt0=",
      "status": "SUCCESS",
      "additionalStatus": "AVAILABLE_DATA_RETRIEVED",
      "accountId": 134539937,
      "providerAccountId": 11333937,
      "isAlreadyVerified": false
    }
  ]
}

Verification (Failed)

Verification failed as there are no verification eligible accounts.

FastLink (Legacy) FastLink 4 
{
  "action": "exit",
  "fnToCall": "accountStatus",
  "code": 414,
  "providerAccountId": 11522858,
  "reason": "We couldn't find your account at Dag Site. Sometimes a bank site and credit card site look similar. Did you select the correct site? Try searching again. (Error 414)",
  "sites": [
    {
      "providerId": 5,
      "bankName": "Wells Fargo",
      "requestId": "vNHnOZ05sXZF1gFzEpF9BoMlSt0=",
      "status": "FAILED",
      "statusCode": "DATA_NOT_AVAILABLE",
      "providerAccountId": 11522858,
      "reason": "It looks like we're having issues with your account for some reason. Did you close an account at Dag Site? If not, make sure you selected the correct site or come back later to try again."
    }
  ]
}

{
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 5,
      "providerName": "Wells Fargo",
      "requestId": "vNHnOZ05sXZF1gFzEpF9BoMlSt0=",
      "status": "FAILED",
      "additionalStatus": "NO_ACCOUNTS_FOR_VERIFICATION",
      "providerAccountId": 11333937,
      "reason": "You do not have any accounts eligible for verification with this site. Verification eligibility is determined by Company based on the type of data available for this account."
    }
  ]
}

Account Addition Flow Terminated

  • The consumer terminates the account addition flow without attempting.
    FastLink (Legacy) FastLink 4 
    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "status": "USER_CLOSE_ACTION"
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "status": "USER_CLOSE_ACTION",
  "sites": []
}
  • The consumer terminates the account addition flow during the first time attempt, confirming to delete the accounts.
    FastLink (Legacy) FastLink 4 
    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 5,
      "bankName": "Wells Fargo",
      "requestId": "4CQQB7ylnUJcI7DR/D3z111lPy8=",
      "status": "ACTION_ABANDONED/1",
      "providerAccountId": 11333937
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 5,
      "providerName": "Wells Fargo",
      "requestId": "4CQQB7ylnUJcI7DR/D3z111lPy8=",
      "reason": "User cancelled the linking process confirming account deletion.",
      "status": "ACTION_ABANDONED",
      "providerAccountId": 11333937
    }
  ]
}

Manual Account

  • The consumer adds an account manually.
    FastLink (Legacy) FastLink 4 
    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerAccountId": 11548845,
      "bankName": "Custom Bank",
      "status": "SUCCESS"
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "accountId": 12658703,
      "accountType": "CD",
      "providerAccountId": 11548845,
      "container": "bank",
      "status": "SUCCESS",
      "isManual": true
    }
  ]
}
  • The consumer deletes the manually added account.
    FastLink (Legacy) FastLink 4 
    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerAccountId": 11548845,
      "bankName": "Custom Bank",
      "status": "SUCCESS"
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "accountId": 12658703,
      "accountType": "CD",
      "providerAccountId": 11548845,
      "isDeleted": true,
      "container": "bank",
      "status": "SUCCESS",
      "isManual": true
    }
  ]
}

Real Estate Account

  • The consumer adds a real estate account - SmartZip.
    FastLink (Legacy) FastLink 4 
    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerAccountId": 11545871,
      "bankName": "SmartZip",
      "status": "SUCCESS"
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "accountId": 13078724,
      "accountType": "Real Estate",
      "providerAccountId": 11545871,
      "container": "realEstate",
      "status": "SUCCESS",
      "valuationType": "SYSTEM"
    }
  ]
}
  • The consumer adds a real estate account manually.
    FastLink (Legacy) FastLink 4 
    {
  "fnToCall": "accountStatus",
  "action": "exit",
  "sites": [
    {
      "providerAccountId": 11545869,
      "bankName": "Custom Real Estate",
      "status": "SUCCESS"
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "accountId": 13078722,
      "accountType": "Real Estate",
      "providerAccountId": 11545869,
      "container": "realEstate",
      "status": "SUCCESS",
      "valuationType": "MANUAL"
    }
  ]
}
  • The consumer deletes an added real estate account.
    FastLink (Legacy) FastLink 4 
    {
  "fnToCall": "accountStatus",
  "action": "exit",
  "sites": [
    {
      "providerAccountId": 11545869,
      "bankName": "Custom Real Estate",
      "status": "SUCCESS"
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "accountId": 13078722,
      "accountType": "Real Estate",
      "providerAccountId": 11545869,
      "container": "realEstate",
      "status": "SUCCESS",
      "valuationType": "MANUAL",
      "isDeleted": true
    }
  ]
}

Migrating Account to Open Banking (OB) User Login

The consumer is migrating their account from a non-OB to an OB user login, and the migration process takes more time than expected. The application ends the flow and sends this post message.

FastLink (Legacy) FastLink 4 
{
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 19335,
      "bankName": "Dag OAuth",
      "requestId": "vNHnOZ05sXZF1gFzEpF9BoMlSt0=",
      "status": "MIGRATION_IN_PROGRESS",
      "statusCode": "MIGRATION_IN_PROGRESS",
      "providerAccountId": 11333937
    }
  ]
}

{
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 19335,
      "providerName": "Dag OAuth",
      "requestId": "vNHnOZ05sXZF1gFzEpF9BoMlSt0=",
      "status": "MIGRATION_IN_PROGRESS",
      "additionalStatus": "MIGRATION_IN_PROGRESS",
      "providerAccountId": 11333937
    }
  ]
}

Intermediate Events [onEvent(data)]

In the Open Banking flow, the Financial Institution’s login page URL is opened outside FastLink.

FastLink (Legacy) FastLink 4 
{
  "type": "OPEN_EXTERNAL_URL/LAUNCH_BROWSER",
  "data": {
    "url": "https://fi.com/usob/authorize?param1=abc&param2=xyz"
  }
}

{
  "type": "OPEN_EXTERNAL_URL",
  "data": {
    "source": "OB_URL",
    "url": "https://fi.com/usob/authorize?param1=abc&param2=xyz"
  }
}

Micro-Entries Events

  • The consumer clicks manual verification entry point button to exit FastLink and enter the customer’s own external micro-entries process.
    FastLink (Legacy) FastLink 4 
    {
  "action": "exit",
  "fnToCall": "cdvRedirection",
  "pageName": "SEARCH_PAGE"
}

    {
  "action": "cdv_exit",
  "pageName": "SITE_SEARCH",
  "type": "CDV",
  "pageTitle": "SITE_SELECTION"
}
  • The consumer initiates the verification process.
    FastLink (Legacy) FastLink 4 
    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 16441,
      "bankName": "Dag Site",
      "status": "INITIATED",
      "providerAccountId": 10145500,
      "accountId": 10818200
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 16441,
      "providerName": "Dag Site",
      "status": "INITIATED",
      "providerAccountId": 10145500,
      "accountId": 10818200
    }
  ]
}
  • The consumer successfully completes the verification process.
    FastLink (Legacy) FastLink 4 
    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 16441,
      "bankName": "Dag Site",
      "status": "SUCCESS",
      "providerAccountId": 10145500,
      "accountId": 10818200
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 16441,
      "providerName": "Dag Site",
      "status": "SUCCESS",
      "providerAccountId": 10145500,
      "accountId": 10818200
    }
  ]
}
  • The consumer failed the verification process due to submitting incorrect micro-deposit amounts multiple times.
    FastLink (Legacy) FastLink 4 
    {
  "fnToCall": "accountStatus",
  "action": "exit",
  "sites": [
    {
      "providerId": 16441,
      "bankName": "Dag Site",
      "reason": "Account Verification Failed",
      "status": "FAILED",
      "providerAccountId": 10145240,
      "accountId": 10817992
    }
  ]
}

    {
  "action": "exit",
  "fnToCall": "accountStatus",
  "sites": [
    {
      "providerId": 16441,
      "providerName": "Dag Site",
      "reason": "DATA_MISMATCH",
      "status": "FAILED",
      "providerAccountId": 10145240,
      "accountId": 10817992
    }
  ]
}