Returning Users

Learn how and when to return users to Argyle Link for additional actions.

Returning Users sample app cover image

Users connect their payroll accounts via Argyle through our front-end application, Argyle Link.

There may be times when you want to re-connect a user to allow them to take additional actions, such as:

  • Completing required multi-factor authentication (MFA)
  • Connecting additional payroll accounts
  • Managing previously connected accounts, including revoking access
  • Making a direct deposit update

Returning Users sample app

You can find a live demo of how users experience the Argyle Link re-connection process in our Returning Users sample app.

Click here to explore the Returning Users sample app in your browser, or visit our Github repository to clone and test the sample app in your local development environment.

Re-creating the sample app

Visit our in-depth returning users guide to learn how to re-connect users in Argyle Link.

Use the sections below if you would like to quickly re-create the returning user scenarios from the Returning Users sample app.

Adding and managing connections

Re-connect a user to Argyle Link by replacing the linkKey and userToken in the sample Argyle Link initialization code below:

<!DOCTYPE html>
<html>

<head>
    <meta charset="utf-8" />
</head>

<body>
    <script src="https://plugin.argyle.com/argyle.web.v3.js"></script>
    <script type="text/javascript">
        const argyle = Argyle.create({
            linkKey: 'YOUR_LINK_KEY', //found in Argyle Console in the Developers tab
            apiHost: 'https://api-sandbox.argyle.com/v1', // Sandbox environment
            userToken: 'USER_TOKEN', //more info on userTokens can be found in our Returning Users guide
        })
        argyle.open()
    </script>
</body>

</html>

If no additional Argyle Link Customizations were added, by default the user will be taken to an introductory screen followed by the secondary account connection screen shown in the Returning Users sample app demo.

The account connection screen will show any accounts the user has already connected, and allow the user to search for and connect additional payroll accounts.

If an existing connected account is selected by the user, the revoke access screen from the Returning Users sample app demo is shown.

Direct deposit switching

Visit our full direct deposit switching guide for more information.

If you want the user to return to Argyle Link in order to add or update their direct deposit, add the following two lines to your Argyle Link initialization:

payDistributionUpdateFlow: true,
payDistributionConfig: "Your payDistributionConfig goes here"

More information on creating a payDistributionConfig can be found in our direct deposit switching guide.

For this example, we will use the payDistributionConfig for full paycheck re-allocation testing in Sandbox that can be found here in the direct deposit switching guide:

"CiQAB/5lecrbJVrkdodwk4sgqacFNCiaH638IgDAHa8/peRjEEoShwIA8Gmka0Ea+JAa75M5HxfTckMklvPVvRxPYV3ND+YisxMhcHk6Fig0bwUUJiotuw/L5YkbHysTMPU6PSvXnHs19lNDZfVO6qpo44U6eMRdqO65HC864QEEi5n/u7QQT3DcG43RiVoRCnDiBlcdGIOPxth+gX6JgygigFHLEFhfOKWaQdyOmHDuf9cZNxp3M26IBEEtgmznl4oSm1qFt6ZzMcvdvKd2nOMS5co3Nc4f6F67GlnCRHEjzszBUnkgpsj60KFKggQ0e/CRQWi5pM/wa7UCb80LAKKm8Tl07kDJVFZcb9rsGwcfPY8ZCxcD0MtV/Q+yflCbaLL4RYcKXCBZXv0yOJEhxw=="

The Argyle Link initialization for a returning user with direct deposit switching enabled will look like this for our current example:

<!DOCTYPE html>
<html>

<head>
    <meta charset="utf-8" />
</head>

<body>
    <script src="https://plugin.argyle.com/argyle.web.v3.js"></script>
    <script type="text/javascript">
        const argyle = Argyle.create({
            linkKey: 'YOUR_LINK_KEY', //found in Argyle Console in the Developers tab
            apiHost: 'https://api-sandbox.argyle.com/v1', // Sandbox environment
            userToken: 'USER_TOKEN', //more info on user tokens can be found in our Returning Users guide
            payDistributionUpdateFlow: true,
            payDistributionConfig: "CiQAB/5lecrbJVrkdodwk4sgqacFNCiaH638IgDAHa8/peRjEEoShwIA8Gmka0Ea+JAa75M5HxfTckMklvPVvRxPYV3ND+YisxMhcHk6Fig0bwUUJiotuw/L5YkbHysTMPU6PSvXnHs19lNDZfVO6qpo44U6eMRdqO65HC864QEEi5n/u7QQT3DcG43RiVoRCnDiBlcdGIOPxth+gX6JgygigFHLEFhfOKWaQdyOmHDuf9cZNxp3M26IBEEtgmznl4oSm1qFt6ZzMcvdvKd2nOMS5co3Nc4f6F67GlnCRHEjzszBUnkgpsj60KFKggQ0e/CRQWi5pM/wa7UCb80LAKKm8Tl07kDJVFZcb9rsGwcfPY8ZCxcD0MtV/Q+yflCbaLL4RYcKXCBZXv0yOJEhxw=="
        })
        argyle.open()
    </script>
</body>

</html>

Using this initialization, after the user selects a connected account in Argyle Link they will find the direct deposit update button is enabled.

Direct account re-connections

You can bypass allowing the user to connect additional accounts or having to select an existing account before taking further action.

To re-connect a user directly to an existing payroll account they have already connected through Argyle Link, visit our deep-linking guide.

Next steps

Click here to explore the Returning Users sample app in your browser, clone it from our Github repository, or visit our other Sample Apps to see more demos and sample applications made using Argyle.

📘

Reach out to your Customer Success Manager, an Account Executive, or the Support Team for help connecting and re-connecting users through Argyle.