Connect sample payroll accounts

You can connect sample payroll accounts using a sandbox version of Argyle Link, the embeddable UI component where your users connect their payroll accounts.

There are two ways to use the sandbox version of Argyle Link to connect sample payroll accounts:

Use Link Emulator in Argyle Console, no coding required
Embed a sandbox version of Link directly into your application

Connect sample accounts in Argyle Console

To connect sample accounts in Console, follow these steps:

Enable sandbox mode using the toggle at the top of Console's left-hand side panel:

Sandbox mode toggle

Select Argyle Link, then Emulator in left-hand side panel.
Select Continue on the first screen of Argyle Link, then search for and select an employer or payroll provider.
Log in using the credentials for sample accounts.

Embed Link in your app

To embed a sandbox instance of Argyle Link into your web application, include argyle.web.js on your webpage and initialize it by providing a list of configuration options.

You can then invoke the Argyle Link UI element at any time within your application.

See Embedding Link to learn how to embed Link in your web, Android, iOS, or React Native production applications.

Prerequisites

Before embedding Argyle Link, make sure you have your sandbox API keys at hand, available in Console.

Integration examples

Argyle provides integration examples for Web, Swift, Kotlin, and React Native for the sandbox. To run the examples on your machine:

Copy the snippet you need then paste it into an empty index.html file.
Replace the YOUR_LINK_KEY placeholder with your own linkKey, which can be found in the API keys section of the Console in the Link key row.
Open the index.html in a web browser. Argyle Link will open a modal window where you can select a payroll provider and connect payroll accounts.

📘
The apiHost configuration parameter in the example code points to <https://api-sandbox.argyle.com/v1>. This ensures that the plugin starts in a sandbox environment. When integrating with the production API, set the apiHost to <https://api.argyle.com/v1>.

<!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({
        apiHost: 'https://api-sandbox.argyle.com/v1',
        linkKey: 'YOUR_LINK_KEY',
        onAccountCreated: ({ accountId, userId, linkItemId }) => {
          console.log('Account created: ', accountId, ' User ID:', userId, ' Link Item ID:', linkItemId)
        }
      });
      argyle.open();
    </script>
</body>

</html>

_ = Argyle.shared
    .loginWith(linkKey: "YOUR_LINK_KEY", apiHost: "https://api-sandbox.argyle.com/v1")
    .resultListener(self)

let argyle = Argyle.shared.controller
argyle.modalPresentationStyle = .fullScreen
self.present(argyle, animated: true, completion: nil)

val config = ArgyleConfig.Builder()
    .loginWith("YOUR_LINK_KEY", "https://api-sandbox.argyle.com/v1", "")
    .build()

Argyle.instance.init(config)
Argyle.instance.startSDK(this)

import ArgyleSdk from '@argyleio/argyle-plugin-react-native'

// Configure the SDK before hand, once. only call ArgyleSdk.start() when the UI is needed
ArgyleSdk.loginWith("YOUR_LINK_KEY", "https://api-sandbox.argyle.com/v1", "")

// Launch the SDK
ArgyleSdk.start()

Credentials for sample accounts

When you run Argyle Link in the sandbox environment, you can only connect payroll accounts with the provided sandbox credentials. These credentials work for all Link items. Argyle provides three sets of test credentials:

	Bob	Sarah	Joe
Email	[email protected]	[email protected]	[email protected]
Username	test_1	test_2	test_3
Password	passgood	passgood	passgood
Verification code	8081	8082	8083
Phone number	(800) 900-0001	(800) 900-0002	(800) 900-0003
Driver's license	D1230001	D1230002	D1230003

When logging in as a test user, be sure to enter the appropriate credentials. For example, Walmart requires username and password, while Uber requires email and password. For Link items that require SSN numbers, the sandbox environment accepts any 4-digit numerical value.

Select a Link item and connect it using the test credentials. This creates employment data for that test user that you can retrieve.

📘
Note that inactive sandbox accounts are automatically deleted 60 days after creation.