Skip to main content

Administrators: Uploading a contribution correction file

Updated this week

Overview

When you need to update a previously processed Perk or HRA contribution, you can upload a Contribution Correction file in your Admin Dashboard. This ensures contribution amounts are updated accurately across reporting and employee balances.

Please note that Contribution Correction files should only be uploaded for the following benefit types:

  • Perk

  • HRA

  • Front-loaded Parking/Transit

For pay dates on or after March 23, 2026:

Negative deductions for the following benefit types are processed automatically and do not require a Contribution Correction file:

  • Dependent Care FSA (DCFSA)

  • Parking

  • Transit

Negative deductions will be applied as negative contributions and reflected in reporting and employee balances.

For HSAs:

  • As of March 23, 2026, Benepass will ingest negative HSA deductions via your payroll integration, but they are not automatically processed in all cases.

  • Do not upload a Contribution Correction file for HSA balance corrections.

  • Instead, notify Benepass when you want negative HSA deductions to be applied after being updated in payroll integration deduction files.

Additional note:
If an HSA account is closed or not opened, contributions cannot be applied, and employers may need to return funds directly to employees.

Why this matters

For Perk, HRA, and front-loaded Transit & Parking benefits, using the contribution correction process ensures:

  • Accurate contribution balances for employees

  • Clean reporting and reconciliation

  • Faster processing with fewer manual interventions


How to upload a Contribution Correction file

Follow these steps when you need to update a Perk, HRA, or front-loaded Parking/Transit contribution correction:

  1. Go to the Uploads tab in your Admin Dashboard.

    1. Select “Contribution correction” as the upload type.

  2. Download and complete the Contribution Correction file template (attached to this article).

    1. This template helps us identify the exact contribution to be updated and the corrected amount.

  3. Gather the data you’ll need.

    1. Use the Contributions and expirations report in your Admin Dashboard to find the affected contributions:

      • Filter by the specific employee

      • Filter by the affected benefit(s)

      • Identify the contributions that need to be corrected

  4. Locate the Contribution Internal Object ID.

    • This ID appears in the Contributions report under the Internal Object ID column.

    • It will begin with contrib_.

    • Include only contribution IDs in the file (do not mix deduction and contribution IDs).

In the contribution correction file upload:

  • Column A should match the employee’s email address as it appears in the Benepass system

  • Column B should include the contribution ID of the contribution you wish to reverse.

  • Column C should include the amount that was originally contributed

  • Column D should include what the new amount should be

You will then upload this to the admin dashboard as a "Contribution correction":

Once submitted, our engineering team will process the update(s) within two weeks.

FAQs

When did this change take effect?

This change went into effect on March 23, 2026.

Negative deductions for eligible benefits with pay dates on or after March 23, 2026 are processed automatically and do not require a Contribution Correction file.

Negative deductions with pay dates before March 23, 2026 will still require a Contribution Correction file.

When should I use a Contribution Correction file?

Only for correcting:

  • Perk

  • HRA

  • Front-loaded Parking and/or Transit

What should I do instead for DCFSA, Transit, or Parking?

Submit a negative deduction through your payroll integration and notify Benepass.
This will automatically adjust contributions—no contribution correction file upload needed.

What about HSAs?

  • Do not use a Contribution Correction file

  • Send negative deductions through your payroll integration and notify Benepass admin support

How do corrections appear in reporting?

Negative deductions are reflected as negative contributions in both:

  • Admin reporting

  • Employee app

Did this answer your question?