Rippling – Vestwell Help Center

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.

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

  1. Determine Your Integration Type
  2. Initiate Your Integration Setup
  3. Are There Any Reasons Why My Plan Might Not Be Eligible for an Integration?
  4. What Are My Responsibilities If My Plan Has an Active Payroll Integration?
  5. What Do You Handle for Me If My Plan Has an Active Payroll Integration?
  6. Will My Payroll Provider Charge Me Fees to Set Up and/or Maintain My Payroll Integration?
  7. What if I Amend My Plan or Change the Frequency of My Employer Contributions?
  8. How Do I Disconnect My Integration?

Determine Your Integration Type

There are two possible integration types. Your eligibility depends on your prior relationship with us and your payroll setup.

API – How to Initiate Your Integration Setup (for Prior Accrue Clients)

To initiate your integration:

  1. Log in to your employer portal.
  2. Navigate to the "Contributions" page.
  3. Click the gear icon.
  4. Click the Connect to Rippling button.
  5. Follow the steps to authorize your connection.
    • Please ensure that you select “Everyone except contractors should have an account” when prompted with “Who should have an account for Vestwell” as you authorize your connection.
    • Please ensure that you select “As soon as they’ve signed their offer letter or agreement when prompted with “If an employee (or consultant) matches the access rules, when should they get access to Vestwell?” as you authorize your connection.

If your plan has multiple pay groups, you must add a pay schedule name to identify each pay group. You can do this by following the next steps:

  1. From the main sidebar, select Payroll.
  2. From the Payroll sidebar, select Payroll Overview.
  3. Select the "Settings" tab.
  4. Select the "Pay schedules & auto approval" section.
  5. Click Review your pay schedules.
  6. Click Edit and enter a new pay schedule name.
  1. From the main sidebar, select Payroll.
  2. From the Payroll sidebar, select Settings.
  3. Select the "Pay schedules" section.
  4. Click Edit and enter a new pay schedule name.

Please do not run payroll until you see "Vestwell Integration" retirement deduction codes. These will appear 4 business days before your first payroll with us. You can locate the codes in Rippling by following the instructions below:

  1. Log in to Rippling.
  2. Navigate to "Payroll" → “Payroll Overview” → “Deductions” → “Recurring deductions for active employees”.
  3. Look for the below codes:
    • Vestwell Pretax 401k
    • Vestwell Roth 401k
  4. If your plan allows, loans will also be set up within Rippling through the integration.

Note: If you have existing Pretax or Roth codes in Rippling, they will be deactivated. Any existing IRA codes must be deactivated by you, the employer.

For plans with multiple EINs:

  1. Ensure at least one pay group is set up in your retirement plan portal for each company you need to connect.
  2. Click Connect to Rippling.
  3. Log in to your Rippling account, then select the company you want to connect.
  4. You’ll be redirected back to the retirement plan portal to map the selected company to existing pay groups.
    • Note: Only map pay groups associated with this company. You can connect additional companies later.
  5. Click Connect.
  6. To connect another company, click Connect to Rippling again and select a different Rippling company.
  7. Repeat steps 4–5 for each EIN.
  8. A connection is complete when a green checkmark with “Connected” appears next to the pay group.

Pay(k)onnect – How to Initiate Your Integration Setup

To initiate your integration, reach out to your Rippling Account Manager to purchase the 401k subscription package in Rippling, then log in to your Rippling portal and add Vestwell as an app from the Rippling Marketplace.

Note: If your integration has not yet been activated, contribution uploads into your employer portal will be required until our team notifies you that the integration can begin.

Turn off the Secure Act 2.0 default deduction within Rippling.

  1. Navigate to the "Manage Deductions" page of the payroll integration.
  2. Scroll to the 401(k) deduction.
  3. Click the three dots to the right and select Edit.
  4. Navigate to the 4th page.
  5. Under "Configure employee contributions," check the box to opt-out.
  6. Continue through the deduction set up and click Save.
  7. Lastly, set up and maintain retirement loans within your payroll system.

Work with your payroll representative to set up and maintain payroll codes within your payroll system. It is important that these payroll codes do not change once the integration setup is completed.

  1. Navigate to the "Manage Deductions" page of the payroll integration.
  2. Scroll to the 401(k) deduction.
  3. Click the three dots to the right and select Edit.
  4. Navigate to the 3rd page.
  5. Set up the employer contribution.

Note: If your employer contribution is only one tier, Set 0% of 0% for the second tier.

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. This includes:

What Are My Responsibilities if My Plan Has an Active Payroll Integration?

Our ability to successfully process your payroll files and administer your plan depends on you. Your responsibilities as an employer with an active payroll integration are outlined below.

Payroll Codes

Loans

Discretionary and/or Profit-Sharing Contributions

Mandatory Employer Contributions

Pay Groups

Employee Status Changes - Payroll System

Employee Personal Information

Pay Frequency/Schedule Changes

Negative Contributions/Corrections

Review Payroll Data

What Do You Handle for Me If My Plan Has an Active Payroll Integration?

Employee Deferrals - First Integrated Payroll

Employee Deferral Updates

Employee Status Changes In The Portal

Processing Contributions

Will My Payroll Provider Charge Me Fees to Set Up and/or Maintain My Payroll Integration?

Your payroll provider may charge fees in conjunction with the integration. Please check with your Rippling representative for more specific details.

We will not charge you to facilitate this integration.

What if I Amend My Plan or Change the Frequency of My Employer Contributions?

If your plan has been amended or if you are considering an amendment to your original plan documents, you are responsible for informing your payroll provider of the updates.

If you have changed the frequency of funding your employer contribution, you are responsible for informing your payroll provider and working with them to make this update.

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 retirement plan representative, and we will assist you.