Overview

Retrieve and refresh data from existing Links using Data Refresh endpoints. Requests to these endpoints initiate data refresh activity for connected accounts. Using Data Refresh, users avoid repeating credential authentication steps. Webhooks and the Retrieve a data refresh status endpoint also provides information on Task status.

📘

Note

Refresh status may result in an error state if a user has changed their password or their session has expired.

Session timing

Users logging into a web service creates a session. With Truv, payroll systems determine the session duration when connecting. Data refreshes automatically during any active session.

Authentication issues

Data refresh issues may result from authentication. View the table below for troubleshooting.

Resolving with re-authentication

For login_error or mfa_error status values, prompt users with re-authentication. This allows users to reconnect to and validate payroll provider information.

Use the Create a bridge token endpoint to create a new bridge_token value. This endpoint also receives the previous access_token from the Create a data refresh task request body.

With a new bridge_token value, initialize Truv Bridge for the user. This prompts the applicant to re-authenticate and grant access to the most recent data from the payroll provider. When the Truv Bridge callback returns successfully, all of the most recent data becomes available to Truv endpoints.