Returning Users
Learn how and when to return users to Link for additional actions.
We'll be updating our Sample App Github repositories for API v2 and Link 5 in 2023 Q3.
Overview#
Users connect their payroll accounts via Argyle through our front-end application, Argyle Link.
There may be times when you want to allow users to return to Link 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 reconnection 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:
1<!DOCTYPE html>
2<html>
3
4<head>
5 <meta charset="utf-8" />
6</head>
7
8<body>
9 <script src="https://plugin.argyle.com/argyle.web.v3.js"></script>
10 <script type="text/javascript">
11 const argyle = Argyle.create({
12 linkKey: 'YOUR_LINK_KEY', //found in Argyle Console in the Developers tab
13 apiHost: 'https://api-sandbox.argyle.com/v1', // Sandbox environment
14 userToken: 'USER_TOKEN', //more info on userTokens can be found in our Returning Users guide
15 })
16 argyle.open()
17 </script>
18</body>
19
20</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:
1payDistributionUpdateFlow: true, 2payDistributionConfig: "Your payDistributionConfig goes here"
More information on creating a payDistributionConfig can be found here 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:
1"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:
1<!DOCTYPE html>
2<html>
3
4<head>
5 <meta charset="utf-8" />
6</head>
7
8<body>
9 <script src="https://plugin.argyle.com/argyle.web.v3.js"></script>
10 <script type="text/javascript">
11 const argyle = Argyle.create({
12 linkKey: 'YOUR_LINK_KEY', //found in Argyle Console in the Developers tab
13 apiHost: 'https://api-sandbox.argyle.com/v1', // Sandbox environment
14 userToken: 'USER_TOKEN', //more info on user tokens can be found in our Returning Users guide
15 payDistributionUpdateFlow: true,
16 payDistributionConfig: "CiQAB/5lecrbJVrkdodwk4sgqacFNCiaH638IgDAHa8/peRjEEoShwIA8Gmka0Ea+JAa75M5HxfTckMklvPVvRxPYV3ND+YisxMhcHk6Fig0bwUUJiotuw/L5YkbHysTMPU6PSvXnHs19lNDZfVO6qpo44U6eMRdqO65HC864QEEi5n/u7QQT3DcG43RiVoRCnDiBlcdGIOPxth+gX6JgygigFHLEFhfOKWaQdyOmHDuf9cZNxp3M26IBEEtgmznl4oSm1qFt6ZzMcvdvKd2nOMS5co3Nc4f6F67GlnCRHEjzszBUnkgpsj60KFKggQ0e/CRQWi5pM/wa7UCb80LAKKm8Tl07kDJVFZcb9rsGwcfPY8ZCxcD0MtV/Q+yflCbaLL4RYcKXCBZXv0yOJEhxw=="
17 })
18 argyle.open()
19 </script>
20</body>
21
22</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#
Demo 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.