Use these credentials when testing with Truv Bridge in sandbox mode.Documentation Index
Fetch the complete documentation index at: https://truv.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Sandbox returns canned datasets — payloads, pay-period dates, and document parsing results are not derived from the actual input. Use sandbox to test integration shape (auth, callbacks, webhook handling, error paths). For recency-sensitive logic (e.g., decisioning that depends on whether pay periods fall within the last N days), validate against production data — sandbox dates may not match the current calendar window.
Sandbox credentials
- Universal Login Scenarios
- Employer / Payroll
- Financial Accounts
These credentials apply to all products. Use them to test authentication flows and error handling.
| Username | Password | Scenario |
|---|---|---|
goodlogin | goodpassword | Successful login with complete data |
goodlogin | no_data | No data found after successful login |
goodlogin | mfa | MFA flow: enter code: 12345 |
goodlogin | mfa_captcha | MFA flow: enter answer: 9M4BP |
goodlogin | mfa_select | MFA flow: verification method selection |
goodlogin | longcheck | Wait state: ~30 second processing delay |
error.user | login_error | Incorrect credentials |
error.user | mfa_error | MFA verification failed |
error.user | account_locked | Account locked by provider |
error.user | unavailable | Provider under maintenance |
error.user | error | Generic login error |
error.user | config_error | Organization ID configuration failure |
Sample reports
These sample PDFs show the verification reports generated for specific test credential scenarios. Use them to preview report formatting and data structure before building your integration.VOIE reports
| Scenario | Credentials | Sample PDF |
|---|---|---|
| Standard (bi-weekly) | goodlogin / goodpassword | Download PDF |
| Weekly pay frequency | goodlogin.weekly / goodpassword | Download PDF |
| Semi-monthly pay frequency | goodlogin.semimonthly / goodpassword | Download PDF |
| Monthly pay frequency | goodlogin.monthly / goodpassword | Download PDF |
To generate your own sample reports in sandbox, create an order with the desired test credentials, then retrieve the report using
GET /v1/users/{user_id}/reports/{report_id}/?fmt=pdf. See Sample Reports for retrieval details.Testing in production
Test scenarios are also available in production mode using the following providers. Search for them by name in Truv Bridge.| Provider | Type | Use case |
|---|---|---|
| Truv Payroll Provider | Payroll | Test VOIE, VOE, DDS, and PLL flows |
| Truv Bank OAuth | Financial accounts (OAuth) | Test asset and transaction flows with OAuth login |
| Truv Bank non-OAuth | Financial accounts (credentials) | Test asset and transaction flows with username/password login |
Refresh testing
Data refreshes automatically succeed withgoodlogin / goodpassword. To test a failed refresh, use goodlogin / mfa_captcha for the initial verification. The refresh will fail with mfa_error status.
Native reset for authentication
Truv Sandbox supports authentication reset workflows. Enter values in the requested fields, then usegoodlogin credentials for MFA verification.
For embedded flows, borrowers may be required to complete MFA during refresh. Use MFA credentials in the original verification and trigger a data refresh via the API to test this scenario.
Native login via mobile SDKs
Native logins in mobile SDKs in sandbox are available when usingTruv payroll provider. Native login for other providers works in production mode only.
Supported companies for testing
The list below contains the available information for Mapping. These companies return acompany_mapping_id value for integration.
- Facebook: Workday
- Bank of America: Company with single sign on
- Kroger: Custom integration
- Fannie Mae: ADP
- Freddie Mac: Workday
In the emulator, only sandbox companies have the correct
company_mapping_id value. Production environments have all valid mapping information values for many large US-based organizations and data providers.