The Link Money Web Gateway offers several options to control the exit flow for different user experiences. These options are:
To set up a redirect flow, follow the authentication steps in the Quickstart Guide and add an additional redirectUri
query parameter to your call:
[<https://external-accounts-webapp-dev.herokuapp.com/>](<https://linkmoney-gateway-dev.fingoal.com/?uuid=1234>)api/authenticate
?token={YOUR_BEARER_TOKEN}
&redirectUri=${YOUR_REDIRECT_URI}
After authentication, the user is automatically redirected to the Link Accounts Portal interface, where they can link accounts from different institutions. When they close the account linking flow, they will be automatically redirected to the specified redirect URI.
<aside>
⚠️ The redirectUri
query parameter must have an https://
or http://
prefix for the callback to properly redirect.
</aside>
The callback has a single parameter, events
, and looks similar to the following URI. The events parameter is a JSON-formatted array of events that follow the event schema.
YOUR_CALLBACK_URI?events=[{
"user_id": "organizationID:userID",
"item_id": "13829803",
"institution": { "name": "Dag Site", "institution_id": "16441" },
"accounts": [{
"balances": {
"limit": 10000, // nullable
"current": 23101.14,
"available": 28101.14,
"iso_currency_code": "USD", // nullable
"unofficial_currency_code": 1000 // nullable
},
"name": "Business Checking - 4531",
"mask": "9060",
"official_name": "Business Checking - 4531",
"type": "depository",
"subtype": "checking",
"id": "20039400"
}]
}]
<aside>
⚠️ Note: For developers coming from Plaid, the Link Money Web Gateway differs from Plaid’s Link in one significant sense: Where Plaid terminates the linking process after the user connects a single item, Link Money offers users the opportunity to link several different items in a single session. Each event
in the events array corresponds with a single item_id
and contains the institution and account data associated with that item’s link.
</aside>
If you are developing in the CDP environment, you will not be able to use the redirectUri
flow successfully. As an alternative, LinkMoney offers the data through the LinkMoney Connector.