---
title: How do I troubleshoot a failed connection to a data source?
description: If a connection to a data source fails, there are several possible issues to address. Here’s how you can troubleshoot common errors:
---

[Skip to content](https://help.truv.com/how-do-i-troubleshoot-a-failed-connection-to-a-data-source#main-content)

[![logo-truv-4](https://help.truv.com/hubfs/logo-truv-4.svg)](https://help.truv.com/?hsLang=en)

Open main navigation

Close main navigation

 How can we help?

- There are no suggestions because the search field is empty.

1. [Truv Help Center](https://help.truv.com/?hsLang=en)
2. [Getting Started](https://help.truv.com/getting-started?hsLang=en)
3. [Platform Overview](https://help.truv.com/getting-started?hsLang=en#platform-overview)

# How do I troubleshoot a failed connection to a data source?

If a connection to a data source fails, there are several possible issues to address. Here’s how you can troubleshoot common errors:

### 1. Invalid Credentials

- The user’s login credentials are incorrect or outdated.
- Solution: 
    - The borrower will be prompted to reset their password or re-enter their login information.
    - They should follow the prompts to update their credentials and try connecting again.

### 2. Configuration Error

- The user enters valid credentials but encounters a configuration error. This usually indicates a technical issue with the payroll provider or data source.
- Solution: 
    - The borrower should not attempt to resolve the issue themselves.
    - Next Step: Move to alternative verification methods, such as document uploads (e.g., pay stubs) or connect to financial institutions to continue the verification process.

### 3. Payroll Provider Unavailable

- The error indicates that the payroll provider is temporarily unavailable, meaning the system cannot connect to the provider at that moment.
- Solution: 
    - The borrower should switch to alternative verification options (e.g., upload documents or use bank account connections) to proceed with verification.

### 4. Minimizing Failures

- Truv continuously monitors success rates for payroll providers to anticipate potential issues. This allows lenders to pre-plan for fallback options in case certain providers experience problems. This minimizes disruptions and ensures a smooth verification process.

### 5. Multi-Factor Authentication (MFA) Errors

- The user faces an MFA error, such as a failed verification code or an issue with completing the authentication.
- Solution: 
    - The user should re-authenticate by going through the MFA process again.
    - This may involve entering a new verification code or using an alternate authentication method, depending on the provider’s options.

- [Getting Started](https://help.truv.com/getting-started?hsLang=en#main-content)

    - [Intro to Truv](https://help.truv.com/getting-started?hsLang=en#intro-to-truv)
    - [Account Setup](https://help.truv.com/getting-started?hsLang=en#account-setup)
    - [Platform Overview](https://help.truv.com/getting-started?hsLang=en#platform-overview)
    - [Dashboard Essentials](https://help.truv.com/getting-started?hsLang=en#dashboard-essentials)
- [Security and Compliance](https://help.truv.com/security-and-compliance?hsLang=en#main-content)

    - [Data Security](https://help.truv.com/security-and-compliance?hsLang=en#data-security)
    - [Regulatory Compliance](https://help.truv.com/security-and-compliance?hsLang=en#regulatory-compliance)
    - [User Consent Management](https://help.truv.com/security-and-compliance?hsLang=en#user-consent-management)
    - [Customer Support for Security](https://help.truv.com/security-and-compliance?hsLang=en#customer-support-for-security)
    - [Incident Response](https://help.truv.com/security-and-compliance?hsLang=en#incident-response)
    - [Certifications & Audits](https://help.truv.com/security-and-compliance?hsLang=en#certifications-audits)
- [Troubleshooting](https://help.truv.com/troubleshooting?hsLang=en#main-content)

    - [API Troubleshooting (High-Level)](https://help.truv.com/troubleshooting?hsLang=en#api-troubleshooting-high-level)
    - [Data Connections](https://help.truv.com/troubleshooting?hsLang=en#data-connections)
    - [Integration Issues](https://help.truv.com/troubleshooting?hsLang=en#integration-issues)
    - [Contacting Support](https://help.truv.com/troubleshooting?hsLang=en#contacting-support)
    - [Resources for Self-help](https://help.truv.com/troubleshooting?hsLang=en#resources-for-self-help)
    - [Account Management](https://help.truv.com/troubleshooting?hsLang=en#account-management)
- [Home Lending](https://help.truv.com/home-lending?hsLang=en#main-content)

    - [FAQs](https://help.truv.com/home-lending?hsLang=en#faqs)
    - [Orders](https://help.truv.com/home-lending?hsLang=en#orders)
    - [Encompass Integration](https://help.truv.com/home-lending?hsLang=en#encompass-integration)
    - [Blend Integration](https://help.truv.com/home-lending?hsLang=en#blend-integration)
    - [nCino Integration](https://help.truv.com/home-lending?hsLang=en#ncino-integration)
    - [BlueSage Integration](https://help.truv.com/home-lending?hsLang=en#bluesage-integration)
    - [Lodasoft Integration](https://help.truv.com/home-lending?hsLang=en#lodasoft-integration)
    - [Tidalwave Integration](https://help.truv.com/home-lending?hsLang=en#tidalwave-integration)
    - [Vesta Integration](https://help.truv.com/home-lending?hsLang=en#vesta-integration)
    - [Byte Integration](https://help.truv.com/home-lending?hsLang=en#byte-integration)
    - [LenderLogix Integration](https://help.truv.com/home-lending?hsLang=en#lenderlogix-integration)
    - [Advanced Dashboard Tips](https://help.truv.com/home-lending?hsLang=en#advanced-dashboard-tips)
    - [Custom Integrations](https://help.truv.com/home-lending?hsLang=en#custom-integrations)
- [Public Sector](https://help.truv.com/public-sector?hsLang=en#main-content)

    - [FAQs](https://help.truv.com/public-sector?hsLang=en#faqs)
    - [Orders](https://help.truv.com/public-sector?hsLang=en#orders)
    - [Clients](https://help.truv.com/public-sector?hsLang=en#clients)
    - [Case Workers](https://help.truv.com/public-sector?hsLang=en#case-workers)
- [Background Screening](https://help.truv.com/background-screening?hsLang=en#main-content)

    - [FAQs](https://help.truv.com/background-screening?hsLang=en#faqs)
    - [Integrations](https://help.truv.com/background-screening?hsLang=en#integrations)
    - [Tazworks](https://help.truv.com/background-screening?hsLang=en#tazworks)
- [Other Use-Cases](https://help.truv.com/other-use-cases?hsLang=en#main-content)

    - [Truv SmartRouting](https://help.truv.com/other-use-cases?hsLang=en#truv-smartrouting)
    - [Truv ChoiceConnect](https://help.truv.com/other-use-cases?hsLang=en#truv-choiceconnect)
    - [Truv Paycheck Pay](https://help.truv.com/other-use-cases?hsLang=en#truv-paycheck-pay)
    - [Truv Scoring Attributes](https://help.truv.com/other-use-cases?hsLang=en#truv-scoring-attributes)
    - [Truv Direct Deposit Switch](https://help.truv.com/other-use-cases?hsLang=en#truv-direct-deposit-switch)
    - [Bank Income](https://help.truv.com/other-use-cases?hsLang=en#bank-income)
- [Account Management](https://help.truv.com/account-management?hsLang=en#main-content)

    - [Team and Account Settings](https://help.truv.com/account-management?hsLang=en#team-and-account-settings)

[![Chill listening crop-3](https://help.truv.com/hubfs/logo-truv-bl.svg "Chill listening crop-3")](https://truv.com/)

Truv Help Center

<https://www.linkedin.com/company/truvhq> <https://x.com/TruvHQ>

Copyright © 2026, Truv Inc.