How it works
Borrower connects payroll
The borrower authenticates with their employer’s payroll system through Truv Bridge.
Configure deduction
You specify the repayment amount as a fixed dollar value or a percentage of net pay.
Automatic deductions begin
Each pay period, the configured amount is deducted from the borrower’s paycheck.
Benefits
Higher Repayment Rates
Payments happen before discretionary spending
Lower Default Risk
Automatic, consistent payments every pay period
Better Borrower Experience
No manual payment management or missed due dates
Real-Time Visibility
Know payment status immediately through webhooks
Deduction types
| Type | Description | Example |
|---|---|---|
amount | Fixed dollar amount | $200 per paycheck |
percent | Percentage of net pay | 10% of each paycheck |
Paycheck Linked Lending uses the User Token flow instead of Embedded Orders. This provides ongoing access to the payroll connection for recurring deductions.
Data coverage
Payroll Providers
Truv connects to payroll providers covering 85%+ of US employees:| Provider | Coverage |
|---|---|
| ADP | ~20% of US workers |
| Paychex | ~10% of US workers |
| Workday | Large enterprises |
| UKG (Kronos) | Healthcare, retail |
| Paylocity | Mid-market |
| Gusto | Small business |
| And 100+ more |
Report structure
The PLL report returns the deduction status and deposit configuration for a borrower’s payroll link.| Field | Description |
|---|---|
id | Unique report identifier |
status | Request status (new, done, error) |
deposit_details.deposit_type | amount (fixed) or percent (percentage of net pay) |
deposit_details.deposit_value | Configured deduction value |
deposit_details.account_number | Target bank account number |
deposit_details.routing_number | Target bank routing number |
deposit_details.bank_name | Target bank name |
deposit_details.account_type | checking or savings |
finished_at | Timestamp when the report completed |
Example PLL report response
Example PLL report response
Manage the lifecycle
Once a Paycheck Linked Lending deduction is active, you can:- Update the deduction amount, adjust as the loan balance changes
- Pause deductions, temporarily suspend during hardship periods
- Cancel deductions, remove when the loan is fully repaid
API reference
Bridge Token
Create tokens for Truv Bridge
PLL Report
Paycheck Linked Lending report
Link Details
PLL link detail report
Users
Create and manage users
Best practices
Cancel deductions when the loan is repaid
Cancel deductions when the loan is repaid
Always cancel the deduction when the loan balance reaches zero to avoid over-collection and maintain borrower trust.
Use fixed amounts for predictable repayment
Use fixed amounts for predictable repayment
Fixed dollar deductions provide consistent repayment schedules. Percentage-based deductions are useful when income varies.
Monitor for payroll connection changes
Monitor for payroll connection changes
Watch for
task-status-updated webhooks to detect if the borrower changes jobs or their payroll provider rejects the deduction.Next steps
Implementation Guide
Step-by-step Paycheck Linked Lending setup
Bridge Widget Guide
Understand the User + Bridge Token integration flow