> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truv.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TidalWave Integration

> Income, employment, and asset verification embedded in TidalWave's SOLO point-of-sale platform

Truv integrates directly with TidalWave's SOLO point-of-sale platform, enabling lenders to verify borrower income, employment, and assets without leaving their existing workflow. Borrowers connect payroll providers or financial institutions through Truv's embedded widget. Data and reports flow back automatically.

<CardGroup cols={2}>
  <Card title="Direct Account Linking" icon="link">
    Borrowers connect payroll or bank accounts within TidalWave's SOLO interface. Skipped steps automatically create follow-up tasks.
  </Card>

  <Card title="Automated Report Delivery" icon="file-arrow-down">
    VOIE and VOA reports with pay stubs and W-2s delivered automatically upon connection
  </Card>

  <Card title="GSE-Ready" icon="building-columns">
    Employment and income data formatted for Fannie Mae DU® and Freddie Mac LPA® submissions directly from TidalWave
  </Card>

  <Card title="Customizable Workflows" icon="palette">
    Configure branding, templates, and notification preferences through the Truv Dashboard
  </Card>
</CardGroup>

***

## How it works

<Steps>
  <Step title="Borrower connects accounts">
    Within TidalWave's SOLO interface, borrowers connect their payroll or bank accounts using Truv's embedded bridge. If a borrower skips verification, TidalWave automatically creates a follow-up task.
  </Step>

  <Step title="Reports generated and delivered">
    Upon connection, Truv delivers VOIE and VOA reports, including employment data, pay stubs, and W-2s formatted for GSE standards, directly into TidalWave.
  </Step>

  <Step title="AUS submission from TidalWave">
    Reports can be submitted to AUS systems (Fannie Mae DU® and Freddie Mac LPA®) directly from within TidalWave.
  </Step>
</Steps>

***

## Go Live with Truv in TidalWave

<Steps>
  <Step title="Contact Customer Success">
    Reach out to your Truv Customer Success Manager to begin onboarding.
  </Step>

  <Step title="Enable Truv as provider">
    Set Truv as your VOIE and VOA provider in TidalWave Company Configurations.
  </Step>

  <Step title="Configure templates">
    Set up verification templates with your branding and Template IDs in the Truv Dashboard.
  </Step>

  <Step title="Test in sandbox">
    Validate the full borrower flow using Truv's test credentials.
  </Step>

  <Step title="Go live">
    Switch to production API keys once testing is complete.
  </Step>
</Steps>

***

## TidalWave Setup Guide

**Step 1:** Log in to TidalWave and navigate to the **Admin** tab.

**Step 2:** Under the **Integrations** section, click **+** to add a new integration.

![Add integration in TidalWave admin](https://files.readme.io/7cad654bba4a0e2685b3262974cac736441312df42797abdffd7c592c8f25963-tidalwave_integration_add.png)

**Step 3:** Select the **Default Branch** or a specific branch to apply the integration to.

**Step 4:** Add your Truv credentials:

* Go to your [Truv Dashboard](https://dashboard.truv.com) and navigate to **Development → API Keys**
* Copy your **Client ID** and **Access Secret**
* Paste both into the corresponding fields in TidalWave

![Enter Truv API credentials in TidalWave](https://files.readme.io/a0bfb839650135a7a93e0ad9ec652294d6fb7a83e76a0dbedb9bfc7a81773d93-Screenshot_2025-07-27_at_10.24.59_PM.png)

![Integration configuration screen](https://files.readme.io/d358655903ea53436960dd7c9725930b0488d7c1731bc86d4b6a1668c58c7d0a-Screenshot_2025-07-27_at_10.33.51_PM.png)

**Step 5:** In **Company Configurations**, enable Truv as the provider for:

* **Employment Income Provider** (for VOIE)
* **Asset Verification Provider** (for VOA)

![TidalWave company configuration settings](https://files.readme.io/ebd15a86b4a080b8e3850074c079911ca0961ca5c948a275b1b4a00d7113ce1a-TidalWave_Integration_Addtional.png)

<Note>
  Test in the sandbox environment before switching to production credentials.
</Note>

***

## Borrower workflow

When verification is triggered:

1. The borrower authenticates using their payroll credentials or a one-time passcode
2. Truv verifies the data and checks for potential fraud
3. A structured report with income, employment, and asset data is delivered to TidalWave for loan officer review
4. If the borrower skips the step, a follow-up task is automatically created in TidalWave

<iframe width="100%" height="400" src="https://www.youtube.com/embed/oH1hTliPLPw" title="TidalWave Integration With Truv" frameborder="0" allow="autoplay; fullscreen; encrypted-media; picture-in-picture" allowfullscreen />

***

## Next steps

<CardGroup cols={2}>
  <Card title="POS Integrations" icon="grid-2" href="/mortgage/integration/pos-overview">
    View all POS integration options
  </Card>

  <Card title="Sandbox Testing" icon="flask" href="/developers/testing/test-credentials">
    Test your integration in sandbox
  </Card>
</CardGroup>

***

## Support

<CardGroup cols={2}>
  <Card title="Truv Support" icon="headset" href="mailto:support@truv.com">
    [support@truv.com](mailto:support@truv.com)
  </Card>

  <Card title="POS Integrations" icon="list" href="/mortgage/integration/pos-overview">
    All supported POS systems
  </Card>
</CardGroup>