User Experience Design

Intro Screen

A best in class implementation and introduction page provides the user with a potential incentive on why they are switching or modifying their direct deposit account, context to understand what the users will need to do, and assurance that when they connect their payroll provider it is private and secure.

Explaining how the user will benefit from connecting their account and that they can instantly complete verification instead of waiting a few days can improve conversion rates.

Truv provides some sample language in an intuitive How it Works section within the widget, but providing your own intro page, tailored and contextual to your users can lead to greater success for you and the user.

Employer Search

  • If you don't know the user's employer, you can use Truv's search enabled by default
  • If you know their company or employer, you can deeplink directly to the employee login.

Use Truv's Search

Truv Bridge is a new way to verify employment history so the majority of users can successfully connect to their employer or payroll account for the first time.

Our search experience was created after testing connections to payroll providers and millions of employers and, using machine-learning algorithms, is always improving. When you don't have data about an employer, the user can search for their current and previous employers inside Truv Bridge.

There are times users don't recall their payroll provider. To help, Truv has intelligently mapped over 2 million employers to the appropriate payroll provider and suggests that payroll provider in the UX. This takes the guesswork away from the user and improves the conversion rate.



We recommend sending all users through Truv Bridge to improve Conversion and Pull through rate.

Build your own Search (Deep linking)

If you know the user's employer, we recommend taking that data into account and deeplinking the user directly to the requisite login input screen in the widget, skipping the employer search screen in the widget.

Additionally, if you know the company name, but don't have the company mapping ID to deep link, you can use our company search endpoint to find it, pass it to the Bridge, and direct the user to the payroll login screen.



In case employer is not mapped we still recommend showing Truv Bridge to all users. This intuitively invites the user to search, select, and connect to their employer or payroll provider.

Direct Deposit Switch allocation

By default, we select 100% of their current allocation for the user to confirm their direct deposit switch.

Some users may not be ready to move their entire direct deposit over to their newly created bank account. In order to overcome this, depending on the payroll provider and where split options are available, the user can select "Split paycheck" with "Split by percentage" or "Split by amount" options within the Truv Bridge.

This allows users to allocate a portion, either a percentage or exact dollar amount, for the new distribution to their new account.

After login attempt

Depending on the result of the connection, the user might be routed to the success screen or it will fall back to other verification options.

Successful connection

There are many options to direct the user after they successfully log in, but here are the two most common:

  1. Show successful status and let user close the Bridge right after login (takes 5-10s on average). You would need to subscribe to Webhooks or poll Truv's backend API to check the status of the data readiness.

  2. Wait for basic employment information to be gathered and parsed and show success only after that (takes ~30-45 seconds on average)


After successfully connecting account, the best practice is to show to the user a confirmation in your application.

Unsuccessful connection

If your user was not able to connect their account, it's critical to present an alternative method to allow your users to switch or allocate funds to their deposit account account.

Native Reset

If a user forgets their credentials or isn't able to login with the correct credentials, we provide a reset flow in the widget that allows them to reset their password. This keeps them in the experience and provides them an expedited way to reset their password, improving conversion and pull through rates.


We recommend waiting for basic employment information from the API to be ready to present to the user before moving them onto the next step in your UI/UX. This creates trust with the user and they can verify the data before moving to the next step in the your application process.

Did this page help you?