Sandbox
Test Console
Prior to diving in with development work, we recommend familiarizing yourself with Link in our Test Console. The Link Test Console lives in the developer dashboard and will allow you to create Link tokens and launch Pinwheel Link. The Test Console mimics Link token creation and allows you to see how different configurations affect the front-end UI. If you don't have access to the Developer Dashboard, please contact [email protected].
In Sandbox mode, you must use our Sandbox credentials. Live credentials will not work in Sandbox. In order to test with live payroll credentials, you can use our Development Environment.
Sandbox Credentials
In Sandbox mode, you can use the following credentials to test Link:
Field | Value |
---|---|
Company ID | company_good |
Username | user_good * |
[email protected] | |
Password | pass_good |
SSN | 123456789 |
Last 4 of SSN | 1234 |
MFA code | mfa_code |
What street did you grow up on? | pinwheel drive |
*For USPS ONLY: Username value is "12345678"
For providers that support optional multifactor authentication (MFA), use the following credentials to test the MFA flow:
Field | Value |
---|---|
Username | user_mfa |
Email | [email protected] |
To test jobs with an outcome
of error
, use the following credentials:
Field | Value |
---|---|
Username | user_error |
Email | [email protected] |
To test jobs with an outcome
of pending
, use the following credentials:
Field | Value |
---|---|
Username | user_pending |
Email | [email protected] |
In sandbox mode, jobs with a pending
outcome will transition to an error
outcome 60 seconds after the Link flow is completed. If you are subscribed to webhook events in Sandbox mode, you will first get an event with a pending
outcome, followed by an event with an error
outcome.
*Note that in production mode, jobs may remain pending
until they are resolved for up to 24 hours.
On Demand Updates
You can mimic an On Demand Update experience by providing the account_id
of an existing sandbox account when creating a Link token. This will show the happy path, e.g., no user input will be required, which occurs when monitoring_status
is active
.
If you're using the Test Console you can perform an On Demand Update by
- Connecting a new account. You should input your normal parameters; just ensure that the
account_id
field is empty. - Launch Link with
account_id
populated. You can load theaccount_id
that came from step 1 by by clicking "load from last Link session" near theaccount_id
field.
Please contact [email protected] for access to our Developer Dashboard.
Updated over 1 year ago