Add a Custom Tag

Account Selection and Tag

Account Selection

For specific use-cases, it is important to know which account the user will want to work with.

For instance, verifying an account, typically used for money transfers, knowing which account to draw money from is important to avoiding NSFs.

ℹ️

Selected Account Identification

You can store the information about which account your user has selected by collecting and keeping the AccountId, along with the loginId.

Tag

Custom tags can be used to mark specific request or groups of requests according to your own context. For example, if you already have a specific UserId you want to associate with a loginId, it can be done by using a tag.

ℹ️

Note:

Different tags needs to be assigned directly in the iframe Url, using the 'Tag' parameter.

Handling AccountId and Tag

Using the same methods to receive the loginId, you are able to capture both Tag and AccountId information:

Redirected Landing Page URL:

https://example.com/thank-you?loginId=8b35f6c8-e7b6-41d3-98f8-08d68b7f8d31&tag=YourTag&institution=FlinksCapital

JavaScript Event Listener:

{step: "REDIRECT", institution: "FlinksCapital", url: "https://example.com/thank-you?loginId=8b35f6c8-e7b6-41d3-98f8-08d68b7f8d31&tag=YourTag&institution=FlinksCapital"}

Webhook Payload:

If you're using Webhooks to receive your data, the payload will contain the chosen tag:

Example:
(Transactions, balance and holder abbreviated for simplicity)

{
    "ResponseType": "GetAccountsDetail",
    "HttpStatusCode": 200,
    "Accounts": [
        {
            "Transactions": [...],
            "TransitNumber": "77777",
            "InstitutionNumber": "777",
            "OverdraftLimit": 0,
            "Title": "Chequing CAD",
            "AccountNumber": "1111000",
            "Balance": {...},
            "Category": "Operations",
            "Type": "Chequing",
            "Currency": "CAD",
            "Holder": {...},
            "Id": "ae1dac72-70da-4626-fed8-08d682e1ff4a"
        },
        {...}      
    ],
    "Login": {
        "Username": "Greatday",
        "IsScheduledRefresh": false,
        "LastRefresh": "2019-05-09T13:47:46.5227901",
        "Type": "Personal",
        "Id": "5e115eac-1209-4f19-641c-08d6d484e2fe"
    },
    "Institution": "FlinksCapital",
    "RequestId": "1243c283-e0ca-4fda-a5e4-343068430190",
    "Tag":"YourTag"   
}