Truv Sandbox is a free and fully-functional environment for development and testing. All Truv functionality is supported in the Sandbox.

Sandbox gives you access to predefined Sandbox credentials and sandbox companies so you can understand exactly what data you'll get back from Truv.

📘
Only Sandbox companies have correct company_mapping_id in Sandbox. In Production environment you'll be able to see majority of large US-based organizations mapped to data providers.

Emulator

Visit Truv Dashboard to view Emulator and test Truv Bridge without writing any code. Emulator allows you to select a product that Truv supports and apply Deeplinking for skipping screens within Truv Bridge.

Sandbox credentials

There are multiple sandbox credentials available each with different scenarios to test.

Individual users

Certain credentials can be used to test unique scenarios for different products we offer for testing Employment History (VOE), Income and Employment (VOIE), Direct Deposit Switch (DDS), Paycheck Linked Loans (PLL), and Insurance Verification products. For each scenario you wish to test, please refer to the "Eligible products" column below to determine which Truv products these credentials can be used for.

Sandbox credentials

Username	Eligible products	Password	Scenario
any	All	any	Login Error
goodlogin	All	goodpassword	Happy path login with complete data returned
goodlogin	All	mfa	Multi factor authentication login. Use MFA Code 12345. Using any code other than 12345 will result in an MFA error.
goodlogin	All	longcheck	Happy path login that takes a little longer than usual (around 30 seconds) to complete
error.user	All	login_error	Incorrect login and password
error.user	All	mfa_error	Issue with multi-factor authentication
error.user	All	account_locked	Locked account. Needs to be unlocked via provider
error.user	All	no_data	No data found in the provider account
error.user	All	unavailable	Provider is going through maintenance and isn't available
error.user	All	error	Generic login error
wronglogin	VOE, VOIE, DDS, PLL	wrongpwd	Failed importing of payroll data
fulltime	VOE, VOIE, DDS, PLL	goodpassword	Full time sales person
hourly.part-time	VOE, VOIE, DDS, PLL	goodpassword	Hourly part-time worker
partial.data	VOE, VOIE, DDS, PLL	goodpassword	Partial data returned, payroll provider did not provide all data
military	VOE, VOIE, DDS, PLL	goodpassword	Military MyPay data
error.user	VOE, VOIE, DDS, PLL	config_error	Incorrect organization ID
multiple.employments	VOE, VOIE, DDS, PLL	goodpassword	Multiple employments with different employers
multiple.employments2	VOE, VOIE, DDS, PLL	goodpassword	Multiple employments with the same employer
nonactive	VOE, VOIE, DDS, PLL	goodpassword	Employment with an end_date
unemployment	VOE, VOIE, DDS, PLL	goodpassword	Unemployment benefits with weekly pay frequency
goodlogin.shift	VOE, VOIE	goodpassword	Gig worker, including EWA

Sandbox native reset credentials

Truv Sandbox supports all native reset flows we implemented (ex. ADP, Paycom, Paychex and etc). To test the flow you need to:

Enter any values in requested field
Use goodlogin when you asked to enter the verification code on multi-factor authentication screen

Sandbox companies

Sandbox environment supports a limited number of company names that will return a Mapping company_mapping_id. You can choose any one of these values when developing your Truv integration to get a valid company_mapping_id.

Company	Scenario
Facebook	Workday
Bank of America	Company with a single sign on
Kroger	Custom integration
Fannie Mae	ADP
Freddie Mac	Workday