Paystub Parser Setup Guide
Automate paystub data extraction for income verification. Extract gross pay, taxes, net income, and YTD earnings from payslips.
Before You Start
Before setting up your parser, ensure you have:
- A PerfectParser account (sign up at perfectparser.com).
- A healthy credit balance (each paystub page processed consumes 1 credit).
- A sample paystub document (PDF, PNG, or JPEG) to use during the parser setup.
Recommended Fields
We suggest configuring the following schema fields for your Paystub Parser to capture all essential earnings and withholding details.
| Field Name | Type | Description |
|---|---|---|
employee_name | Text | The employee's full name. |
employer_name | Text | The name of the company issuing the paystub. |
pay_period | Text | The payroll date range (e.g. June 1 - June 15, 2026). |
pay_date | Text | The date the check/wages were issued. |
gross_earnings | Number | Pre-tax earnings for the current period. |
net_pay | Number | The final take-home net pay amount. |
earnings_breakdown | Table | Table containing type (e.g., Regular, Overtime), hours, rate, and amount for current earnings. |
deductions_breakdown | Table | Table of withholdings (e.g. Federal Tax, Health Insurance) containing type and amount. |
AI Prompt (Optional)
To help the AI parser extract field values with maximum accuracy, copy and paste the following prompt instructions into the AI Prompt (Optional) field during setup:
Next Steps: Build Your Parser
Ready to build this? Follow our Create a Parser guide for step-by-step dashboard instructions to set up your schema, and then learn how to process files in Bulk Extraction.
Developer Integration
If you want to automate paystub parsing programmatically inside your applications:
- See the Create Parser API Guide to manage your parsers programmatically.
- See the Start Extraction API Guide to submit paystub files and retrieve extracted JSON payloads.
- See the Webhooks Reference to configure automatic webhooks that deliver extraction results to your server as soon as they are completed.
Looking for product features and use cases?