Skip to main content

​
Overview

Payroll Integration is the most comprehensive verification method available through Transcrypts. By connecting directly to payroll providers, it pulls complete employment and income data including employment records, pay statements, W-2s, 1099s, and identity information. Transcrypts supports hundreds of payroll providers including ADP, Gusto, Paychex, Workday, and many more. Users connect through the Transcrypts Bridge widget, authenticate with their payroll credentials, and the platform retrieves structured data directly from the source.

​
How It Works

  1. Generate a Bridge Token — Create a Bridge Token to initialize the Transcrypts Bridge widget
  2. User opens Bridge — The user launches the Bridge widget in your application
  3. Search for employer — The user searches for and selects their employer or payroll provider
  4. Authenticate — The user enters their payroll credentials through Bridge
  5. Data retrieval — Transcrypts connects to the payroll provider and pulls employment and income data
  6. Task tracking — A Task is created and progresses through the connection lifecycle (new -> login -> mfa -> parse -> full_parse -> done)
  7. Data available — Once the Task reaches done status, full employment and income data is available through the API
After the user authenticates and closes Bridge, data processing continues in the background. The full_parse stage handles downloading and parsing pay stubs, W-2s, and other documents. Use webhooks or the Task status endpoint to track completion.

​
Available Data

Payroll Integration provides the richest data set of any verification method. The following categories of data are available after a successful connection.

​
Employment Records

Current and historical employment information including:
  • Employment status (active/inactive)
  • Job title and job type (Full Time, Part Time, Contract, etc.)
  • Start date, original hire date, and end date
  • Base income and pay rate
  • Pay frequency (Monthly, Bi-Weekly, Weekly, etc.)
  • Manager name
  • Employer details (name, address, EIN, phone)
See the Employment documentation for the full attribute reference.

​
Pay Statements

Detailed pay stub data for each pay period:
  • Gross pay and net pay (current and year-to-date)
  • Pay date and pay period (start/end)
  • Earnings breakdown by category (regular, bonus, commission, overtime, other)
  • Deductions by category (federal tax, state tax, retirement, benefits, etc.)
  • Hours worked and basis of pay
  • Links to original pay stub documents
See the Pay Statements documentation for the full attribute reference.

​
Tax Documents

W-2 and 1099 forms retrieved directly from payroll providers:
  • W-2 document files
  • Tax year
  • Wages, tips, and other compensation
  • Federal tax withheld
  • Social Security and Medicare wages
  • Gross pay totals
See the Tax Documents documentation for the full attribute reference.

​
Income Summary

Annual income breakdowns by year:
  • Regular pay
  • Bonus, commission, and overtime amounts
  • Other pay
  • Net and gross pay totals

​
Identity Information

Personal information from payroll records:
  • Full name
  • Social Security Number
  • Date of birth
  • Address
See the Identity documentation for the full attribute reference.

​
Supported Providers

Transcrypts supports hundreds of payroll providers. The platform covers major providers including:
  • ADP (Workforce Now, RUN, TotalSource)
  • Gusto
  • Paychex (Flex, Oasis)
  • Workday
  • Paylocity
  • Paycom
  • UKG (UltiPro, Kronos)
  • Ceridian Dayforce
  • Square Payroll
  • Rippling
Use the Company Autocomplete Search endpoint to search available companies and providers programmatically. The Companies and Data Providers documentation describes company and provider attributes including confidence levels and mapping status.
Each company entry includes a confidence_level and success_rate indicating the likelihood of a successful connection. Use these values to set expectations in your application.

​
Relevant API Endpoints

Bridge Token

Generate a short-lived token to initialize Transcrypts Bridge.

Companies & Data Providers

Search and retrieve company and payroll provider information.

Employment

Retrieve employment records including job details and employer information.

Identity

Access identity information from payroll records.

Pay Statements

Retrieve detailed pay stub data with earnings and deductions.

Tax Documents

Access W-2s and 1099s from payroll providers.

Income & Employment Report

Generate combined income and employment verification reports.

VOIE Reports

Create Verification of Income and Employment reports.

​
Connection Lifecycle

Payroll connections follow the standard Task lifecycle. After the user authenticates through Bridge, the Task progresses through these stages:
StageApproximate TimeDescription
login< 10 secondsAuthentication with payroll provider
mfa10-30 secondsMulti-factor authentication if required
parse~30 secondsCollecting identity, employment, and pay date information
full_parse45 seconds to 5 minutesDownloading and parsing pay stubs, W-2s, and income sources
Each Task has a maximum 20-minute completion limit. If a Task does not reach done status within this window, it will result in an error state.

​
Data Refresh

To refresh payroll data for an existing connection without requiring the user to re-authenticate, use the Data Refresh flow. Pass the existing access_token into a new Bridge Token request to initiate a refresh. This creates a new Task that pulls updated data from the payroll provider. See the Stored Credentials verification method for more details on re-verification workflows.