> ## 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.

# BeSmartee Integration

> Verify borrower income and employment within the BeSmartee digital mortgage POS platform

Integrating Truv with BeSmartee allows lenders to instantly access and verify borrowers' employment and income details from authenticated payroll sources. This integration enhances the accuracy and speed of the verification process, facilitating quicker loan decisions, all within the BeSmartee point-of-sale system.

<CardGroup cols={2}>
  <Card title="Fast Verification" icon="bolt">
    Quickly verify employment and income during the borrower application
  </Card>

  <Card title="Reliable Data" icon="shield-check">
    Accurate data sourced directly from authenticated payroll accounts
  </Card>

  <Card title="Task-Based Workflow" icon="list-check">
    Skipped verifications become tasks in the borrower's to-do list for completion later
  </Card>

  <Card title="Ongoing Monitoring" icon="arrows-rotate">
    Connected accounts monitored continuously for new payroll documents
  </Card>
</CardGroup>

***

## How it works

<Steps>
  <Step title="Borrower connects payroll accounts">
    During the pre-application phase, borrowers and co-borrowers are prompted to connect their payroll accounts using the **Verify Income** section of their BeSmartee loan application.
  </Step>

  <Step title="Reports available in your LOS">
    Once accounts are connected, Truv reports are made available in your connected Loan Origination System (LOS) along with relevant payroll documents.
  </Step>

  <Step title="Task management for incomplete verifications">
    If the Verify Income step is skipped, tasks are automatically assigned to the borrower or co-borrower in their to-do list to complete the verification later.
  </Step>

  <Step title="Ongoing monitoring">
    Connected accounts are continuously monitored for new payroll documents, enabling up-to-date verification reports throughout the origination process.
  </Step>
</Steps>

***

## BeSmartee Setup Guide

**Step 1:** Contact BeSmartee Customer Success to complete the one-time admin configuration.

**Step 2:** Copy your Truv API credentials into the BeSmartee platform:

* Log into the [Truv Dashboard](https://dashboard.truv.com) and navigate to **Development → API Keys**
* Copy your **Client ID** and **Access Secret**

<img src="https://mintcdn.com/truv/zBEYg6BWIhwsJtKG/images/api-keys.png?fit=max&auto=format&n=zBEYg6BWIhwsJtKG&q=85&s=a0d522821b5a5c9badf211ad63189035" alt="Truv API Keys Dashboard" width="1920" height="1080" data-path="images/api-keys.png" />

**Step 3:** Configure webhooks in the Truv Dashboard:

* BeSmartee utilizes webhooks to listen to events on every order from Truv and get updated statuses.
* Ask your BeSmartee Customer Success representative to provide the Sandbox and Production URLs to add to the Truv Dashboard.
* Once you have the URLs for both environments, navigate to **Truv Dashboard → Development → Webhooks** and add a URL for your environment. Each environment requires a specific and separate URL.

<img src="https://mintcdn.com/truv/zBEYg6BWIhwsJtKG/images/besmartee-webhook.png?fit=max&auto=format&n=zBEYg6BWIhwsJtKG&q=85&s=ad4b1e84d63d5524f789cb41361bbdd1" alt="BeSmartee Webhook Configuration" width="1920" height="1080" data-path="images/besmartee-webhook.png" />

**Step 4:** Test the full borrower flow in **Sandbox mode** using Truv's test credentials.

**Step 5:** Obtain production access and confirm end-to-end setup with DU (Desktop Underwriter) and LPA (Loan Product Advisor) systems.

***

## Borrower workflow

Borrowers enter their employment and income information using the **Verify Income** section of the BeSmartee application. Alternatively, they receive tasks in their **TO-DO list** prompting them to connect their accounts through Truv.

<iframe width="100%" height="400" src="https://www.youtube.com/embed/SLDzqylL6ys" title="BeSmartee 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="BeSmartee Support" icon="life-ring">
    Contact BeSmartee customer success for platform-specific setup
  </Card>
</CardGroup>
