Skip to main content

Documentation Index

Fetch the complete documentation index at: https://truv.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Quickstart

Run a minimal Truv integration end-to-end in Python, Ruby, Go, Node.js, or C#. Create a user, launch Bridge, receive a webhook, and fetch a report. Use this to verify your API keys work and understand the core flow before building anything.

Quickstart

Clone, configure, and run in minutes with Docker. Five languages available.

Demo apps

The demo-apps repo implements 12 real integration patterns across four verticals. Each makes live API calls, launches Bridge, receives webhooks, and fetches reports. Pick the demo that matches your use case and use it as a starting point.

Prerequisites

Setup

git clone https://github.com/truvhq/demo-apps.git
cd demo-apps
npm install
cp .env.example .env
Open .env and add your Truv API credentials:
API_CLIENT_ID=your_client_id
API_SECRET=your_secret
Start ngrok in a separate terminal to receive webhooks:
ngrok http 3000
Copy the https://...ngrok-free.dev URL into .env:
NGROK_URL=https://your-tunnel.ngrok-free.dev
Run the app:
npm start        # Express server on :3000
npm run dev      # Vite dev server on :5173
Open http://localhost:5173 and pick a demo.

Choose a demo

VerticalDemoPatternProducts
MortgagePOS ApplicationEmbedded OrdersVOIE, VOA
MortgagePOS TasksEmbedded Orders (multi-task)VOIE, VOE, VOA
MortgageLOSHosted OrdersVOIE, VOE
MortgageDocument ProcessingDocument ProcessingDocument extraction
Public SectorCustomer PortalEmbedded OrdersVOIE, VOE
Public SectorDocument ProcessingDocument ProcessingDocument extraction
Public SectorCase Worker PortalHosted OrdersVOIE, VOE
Consumer CreditSmart RoutingBridge WidgetVOIE
Consumer CreditBank IncomeBridge WidgetIncome Insights
Consumer CreditPayroll IncomeBridge WidgetVOIE
Consumer CreditPaycheck-Linked LoansBridge WidgetPLL
Retail BankingDirect Deposit SwitchBridge WidgetDDS

Which demo fits your use case?

If you’re building…Start with
Mortgage origination (purchase, refi, HELOC)POS Application
Consumer lending (auto, personal, BNPL)Payroll Income or Smart Routing
Co-borrower or multi-product verificationPOS Tasks
Loan processor or caseworker portalLOS or Case Worker Portal
Account funding / direct deposit captureDirect Deposit Switch
Earned wage access or loan repaymentPaycheck-Linked Loans
Income from bank when payroll unavailableBank Income
Benefits eligibility (SNAP, Medicaid, TANF)Customer Portal
Pay stub / W-2 / tax return processingDocument Processing
See Test Credentials for sandbox login scenarios.