Returning User

When a user’s session expires or they change credentials, data refresh requests return login_error or mfa_error. Use Bridge update mode to prompt the user to re-authenticate their existing connection.

When to use

Issue	Description	Refresh status
Changed credentials	User updated their username or password	`login_error`
MFA required	Session expired, provider requires new MFA code	`mfa_error`

Re-authenticate [Server-side]

Create a new bridge token using the access_token from the original connection. This puts Bridge in update mode. The user re-enters credentials without going through employer search.

curl --request POST \
     --url https://prod.truv.com/v1/users/USER_ID/tokens/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Content-Type: application/json' \
     --data '{
  "product_type": "income",
  "access_token": "48427a36d43c4d5aa6324bc06c692456"
}'

{
  "bridge_token": "2f67984a110747d190c39e1022c81837"
}

Re-authenticate with Bridge [Client-side]

<script src="https://cdn.truv.com/bridge.js"></script>
<script>
  var bridgeToken = ''; // bridge_token from your server

  var bridge = TruvBridge.init({
    bridgeToken: bridgeToken,
    onSuccess: function(publicToken) {
      console.log('Re-authenticated successfully');
    },
    onClose: function() {
      console.log('Widget closed');
    }
  });

  bridge.open();
</script>

Retrieve updated data [Server-side]

After successful re-authentication, retrieve the refreshed data.

curl --request GET \
     --url https://prod.truv.com/v1/links/d8a8945ee2b049b193110cfba643f5df/ \
     --header 'X-Access-Client-Id: YOUR_TRUV_CLIENT_ID' \
     --header 'X-Access-Secret: YOUR_TRUV_CLIENT_SECRET' \
     --header 'Accept: application/json'

Next steps

Data Refresh

Refresh data without re-authentication

Task Lifecycle

Understand connection statuses

Bridge Token API

Create bridge tokens

Bridge Events

Client-side events and error codes

​When to use

​Re-authenticate [Server-side]

​Re-authenticate with Bridge [Client-side]

​Retrieve updated data [Server-side]

​Next steps