Connect sample payroll accounts
Learn how to connect sample payroll accounts in Console or programmatically.
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:
- 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 ownlinkKey
, 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 theapiHost
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 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.
Updated about 2 months ago