Since our platform has an integration with your payroll provider, we can take a lot of work off your plate regarding the processing of your payroll files through automation.

OnPay offers a 360° level of integration.

This guide will help you set up your integration as well as help you understand your specific responsibilities for the proper administration and submission of payroll files.

  1. How Does My Integration Work?
  2. Are There Any Reasons Why My Plan Might Not Be Eligible for an Integration? 
  3. How Do I Initiate My Integration Setup?
  4. What Are My Responsibilities If My Plan Has an Active Payroll Integration? 
  5. What Does Vestwell Handle for Me If My Plan Has an Active Payroll Integration?
  6. How Do I Disconnect My Integration?

How Does My Integration Work?

Your integration is a 360° Automated Integration. This is a two-way integration in which Vestwell will automatically receive certain information about your plan and participants from your payroll system, process employee and employer contributions to the plan, and automatically send your employees’ selected deferral elections from their Vestwell portal to your payroll provider.

Are There Any Reasons Why My Plan Might Not Be Eligible for an Integration?

There are some plan design features that currently prohibit the use of payroll integration, including:

  • Plans that have multiple log-ins into their payroll system.
  • Plans that do not have an established recurring pay schedule setup in both Vestwell and the payroll system.
  • Plans that do not use the same payroll provider for all pay group(s).
  • Plans that have limitations preventing each paygroup from being integrated. 
  • Eligibility rules that exclude certain classes of employees, types of compensation, or certain types of hours worked.
  • Plans with per pay period non-mandatory employer contributions.
  • Plans that allow after-tax contributions (only be available if your plan uses a Third Party Administrator). Note: After-tax and Roth contributions are not the same; please see our article "Participant Contribution Types: Differences between Pre-tax, Roth, and After-tax."

How Do I Initiate My Integration Setup?

Let your Vestwell representative know you'd like to integrate. A member of our team will reach out to you after your last payroll date before the integration begins to connect your OnPay account to Vestwell. You will need to be the Company Owner of the OnPay account to complete the connection. This will only take a moment of your time!

Vestwell will then deactivate your existing deduction codes & create new ones. Please do not run payroll until you see the following deduction codes in your OnPay account:
- Vestwell 401(k)
- Vestwell Roth 401(k)

What Are My Responsibilities? 

Our ability to successfully process your payroll files and administer your plan depends on you! It is your responsibility to:


  • Set up and maintain retirement loans within your payroll system.

Discretionary and/or Profit-Sharing Contributions 

  • Set up and maintain non-mandatory employer contributions in your payroll system.
  • Submit non-mandatory employer contributions through your Vestwell portal using an off-cycle upload. Learn how to submit an off-cycle contribution here.

Mandatory Employer Contributions

  • Set up and maintain mandatory employer contributions that are on a frequency other than on a per-pay period basis using an Off-cycle upload. Learn more about off-cycle contributions here.

Pay Groups 

  • Make sure any pay groups in your payroll system are also set up at Vestwell and vice versa. To edit a pay group name or set up new playgroups, please see How to add or change a pay group in your Vestwell account.
  • The number of pay groups or companies in your payroll system may affect your plan’s eligibility to integrate.

Saver Status Changes - Payroll System

  • Make updates in your payroll system when savers are hired, terminated, or re-hired. Include a specific date when making these status changes in your payroll system.

Saver Personal Information

  • Maintain complete, accurate, and up-to-date personal information within your payroll system - including date of birth, social security number, and email address. 

Pay Frequency/Schedule Changes

  • Report any pay frequency or pay schedule changes to your Vestwell representative to ensure there is no delay in processing your payroll files upon making this change in your payroll system.

Review Payroll Data

  • We rely on you to provide us with correct, updated, and complete data about your employees regardless of whether we receive that data directly from you or from your payroll provider. Regular audits and spot checks of the data provided to us will help you quickly identify and rectify any discrepancies.

What Does Vestwell Handle for Me If My Plan Has an Active Payroll Integration?

Payroll Codes

Set up and maintain certain deduction/earnings codes within your payroll system.  Because Vestwell manages the codes, do not change this information unless expressly told to do so by your Vestwell Representative. 

    • Name: Vestwell 401(k)
    • Name: Vestwell Roth 401(k) 

If you have existing Pretax or Roth codes in OnPay, they will be deactivated. You must deactivate any existing IRA codes, the employer.

Saver Deferrals - First Payroll

  • Four business days before your first pay date with Vestwell, we will use the saver deferral rates in the Vestwell portal to set saver elections in your payroll system. To guarantee saver deferral rates have been updated in your payroll system, do not run payroll four business days before your scheduled pay date.

Saver Deferral Updates

  • Ongoing deferral changes made in the Vestwell portal by eligible savers will be set in your payroll system within two business days.
  • We will communicate any deferral update requests to your payroll system. Savers may not see this reflected in their next few paychecks, as it could take time for this update to be reflected.
  • If your plan has an auto-enrollment feature, the same guidelines above apply. Read more about auto-enrollment here.

Saver Status Changes - Vestwell Portal

  • When you add, rehire, or terminate employees in your payroll system, the changes will be reflected in the Vestwell portal.

Processing Contributions

  • Process employee deferrals and employer contributions, which are maintained by the integration shortly after you run payroll in your payroll system.

How Do I Disconnect My Integration?

If you change payroll providers, it is your responsibility to inform us so that we can disconnect your integration and assess whether integration with a different payroll provider is available. Please reach out to your Vestwell Representative, and we will assist you.

If your plan has been amended or if you are considering an amendment to your original plan documents, please inform your Vestwell Representative to understand what actions on your part will be required to submit and process your payroll files correctly.