Changelog

September 8, 2022

Update company legal name, legal address, and phone number in Company Onboard and Console

Companies can now update company legal name, legal address, and phone number in Company Onboard, and administrators can update the company phone number in Console. Legal name and legal address can only be updated before company review is initiated. As always, ensure your system stays in sync with these updates by listening to company update webhooks. Learn more about the company object here.

September 8, 2022

Include employee ID in the payroll journal report

You can now include an employee’s ID as an additional column in our Payroll Journal Report.  When the new query parameter ‘include_employee_id’ is set to true or the ‘Select to include employee ID’ checkbox is selected in Console, we’ll include the new column. Learn more about accessing the payroll journal via API here or visit our Payroll Journal Reports page in Console.

September 1, 2022

No required fields for company creation

You can now create a company object in Check without any of the fields that were previously required (legal name, phone number, address). This update offers more flexibility for custom onboarding flows, making it simpler to create companies and any associated entities with fewer required fields. When a legal name is not provided at creation time, it must subsequently be updated via API using the company ID. Please note that in order for a company to be visible in Console, or to generate links for onboarding, a company legal name and address are required. Learn more about the company object here.

September 1, 2022

Child Support Remittance available in all states (plus D.C.)

You can now configure any child support garnishment to have payments remitted by Check, regardless of the garnishment’s state agency. This week we’ve added support for Alaska, DC, Hawaii, Iowa, Kentucky, Minnesota, New Jersey, North Dakota, Pennsylvania, Rhode Island, South Dakota, and Wyoming. To enable remittance by Check via the API include `managed = true` when creating or updating thepost-tax deduction object. To enable it via Console, check the “Managed (Payment Remitted by Check)" box on the Child Support object. Learn more about Child Support Garnishment Remittance here.

August 25, 2022

Create a company using only legal name

You can now create a company with the company object using only the legal name. This improvement allows you to create company objects earlier and adds flexibility to when you collect address and phone number data in your onboarding flow. While no longer required at company object creation, company address and phone number are still required to initiate enrollment with Check. Learn more about the company object here.

August 18, 2022

Enrollment Profile API, Signatory API

Check is exposing two new API resources, the Enrollment Profile and the Signatory. These APIs enable smooth enrollment processes for your clients. You can read more about them in the Guide to Company Enrollment.

August 18, 2022

View the status of payments for company tax liabilities

You can now determine the status of company tax deposits with the new List Tax Deposits endpoint. A ‘tax deposit’ refers to a payment that a company owes to a tax agency for any payrolls run on Check. Learn more about tax deposits here.

August 18, 2022

Child Support Remittance available in Vermont and West Virginia

Check will now remit payments to the child support agencies in Vermont and West Virginia. For Check to remit the payment, you will need to add the garnishment via the post-tax deduction object and mark ‘managed = true’. See which states Check supports for child support garnishments remittance here

August 18, 2022

Improved Tax Setup Onboarding Component

We have released a new and improved version of our Tax Setup Onboarding Component that will streamline the tax setup workflow for employers. This new experience includes SUI rate validation (in both the Tax Setup UI and API), SUI rate guidance for new employers, detailed tax parameter labels and descriptions, support links, and more. Learn more about the Tax Setup Component here.

August 4, 2022

POST multiple items concurrently to /payroll_items

You can now create multiple items for a payroll concurrently. To create items in bulk, pass in a JSON array of payroll items when making a `POST` request to the `payroll_items` endpoint. Learn more about creating payroll items here.

August 4, 2022

Pay 1099 contractors via the Run Payroll Component

You can now add contractor payments to payrolls using the Run Payroll Component. Without any additional engineering work or configuration, you can now set payment and reimbursement amounts for both individual and business contractors. Learn more about the Run Payroll Component here.

July 28, 2022

Child Support Remittance now available in Alabama, Delaware, Idaho, Maine, and New Mexico

Check will now remit payments to the child support agencies in Alabama, Delaware, Idaho, Maine, and New Mexico. For Check to remit the payment, you will need to add the garnishment via the post-tax deduction object and mark ‘managed = true’. See which states Check supports for child support garnishments remittance here.

July 28, 2022

Check Onboard will now request number of W2 employees

A new, optional question asking employers to enter the number of W-2 employees they expect to pay has been added to Company Onboard. This will help Check's risk team more accurately assign payroll processing decisions during the enrollment process. Learn more about Check Onboard components here.

July 22, 2022

Child Support Remittance now available in South Carolina

Check will now remit payments to the child support agencies in South Carolina. For Check to remit the payment, you will need to add the garnishment via the post-tax deduction object and mark ‘managed = true’. See which states Check supports for child support garnishments remittance here.

July 21, 2022

Automatic Federal EIN Verification and API

Check will now dynamically verify a Company’s Federal EIN submitted via Check Console or the Tax Setup API. Normally this verification will take less than 10 seconds. Learn more about Automatic Federal EIN Verifications here.

July 20, 2022

Child Support Remittance now available in Nebraska, Maryland, Ohio, and Missouri

Check will now remit payments to the child support agencies in Nebraska, Maryland, Ohio, and Missouri. For Check to remit the payment, you will need to add the garnishment via the post-tax deduction object and mark ‘managed = true’. See which states Check supports for child support garnishments remittance here.

July 19, 2022

Offer health insurance with the SimplyInsured Component

You can now offer small group health insurance through our integration with SimplyInsured. SimplyInsured is an online platform that helps small businesses compare and purchase employee medical, dental, and vision insurance plans, covering over 95% of the US population. The SimplyInsured Component enables partners to drive new revenue from a health benefits offering, and launch 75% faster than a direct integration. Learn more about the SimplyInsured Component in our Integration Guide, or reach out for more information.

July 18, 2022

SUI Rate Validation via API

Check will now validate Employer SUI rates submitted via Check Console and the Tax Setup API to reduce the number of incorrect submissions. Tax values submitted without an effective date will be validated using the current date of submission. For example, if a tax value is submitted without an effective date on 2022-07-18, then validation will be performed by assuming the value is effective on 2022-07-18. To learn more about specific validation constraints use the GET endpoint to ‘list a company's tax parameters’ and refer to the ‘definitions’ field.

July 15, 2022

Child Support Remittance now available in Mississippi and Oklahoma

Check will now remit payments to the child support agency in Mississippi and Oklahoma. For Check to remit the payment, you will need to add the garnishment via the post-tax deduction object and mark ‘managed = true’. To see which other states are supported, see our State Coverage Tracker.

July 15, 2022

Enable next day payments via API

You can now update processing periods from 2-day to 1-day via API. This change makes it possible to edit ‘processing_period’ for a payroll object in a draft state, making it easy to switch payrolls from 2-day to 1-day (and vice versa) programmatically. Please note, there is additional cost associated with moving to 1-day processing, so reach out to the Check team before upgrading. Learn more about processing periods in our knowledge base.

July 15, 2022

Effective dates in the company defined attributes API

Check now supports effective dating for the company defined attributes API. When an `effective_start` is not defined, if the attribute has not yet been initialized, it will be set to 1900-01-01. Otherwise, Check will set the `effective_start` to the current date by default. To learn more about company defined attributes, see our guide here.

July 14, 2022

Definitions for tax parameters

The Tax Setup API will return a new ‘definitions’ field as part of the ‘tax parameter object’. This new field provides more information regarding the tax parameter setting values, including the minimum, maximum and any associated constraints. As of right now, the definitions are only available for SUI rate tax parameters. Learn more about tax parameter definitions here.

July 7, 2022

Fund payrolls by wire

You can now approve payrolls via wire up until 2PM PT the day before payday via the API or Check Console. This provides a more automated way to fund and expedite payrolls via wire. In Console, you will see an option to fund by wire when a payroll is within a draft state (see Loom demo). Through the API, you can send a PATCH request with ‘funding_payment_method’: ‘wire’ and then approve normally. Learn more about funding payrolls by wire in the API here.

July 1, 2022

LIST valid formats for tax parameters

The Tax Setup API will return a new ‘valid_formats’ field as part of the ‘tax parameter object’. This field will list acceptable formats for that particular tax parameter. This is only available for EIN tax parameters. Learn more about the tax parameter object here.

June 29, 2022

Update to Company Payroll list view in Console

The Company Payroll tab in Check Console will now list 10 payrolls per page instead of the previous 25 per page. This change should speed up load times for this tab going forward. Learn more about working with Check Console here.

June 23, 2022

Support added for additional withholdings in Utah

You can now request additional withholding of Utah income tax for Utah employees. New and existing Utah employees will have their additional withholdings set to $0, and can have this value edited in Check Console. Learn more about release notes specific to Utah here.

June 22, 2022

View cash requirement report

You can now view the breakdown of payroll cash requirements by employee and contractor via a CSV or JSON response. This gives more visibility into how taxes, direct deposit, and post-tax deductions impact the cash requirement. Learn more about accessing the cash requirement report via API here.

June 22, 2022

Create year-to-date limits on miscellaneous post-tax deductions

You can now add an annual limit to miscellaneous post-tax deductions through the Check API and Console. This limit can be set using the `annual_limit` field in the `miscellaneous` object. Once the `annual_limit` is deducted for the calendar year, this PTD will no longer apply for the given year. This feature can be used to support programs like CalSavers, by correctly setting the annual limit for the given year. Learn more about setting annual limits on post-tax deductions here.

June 10, 2022

Include taxable wages in payroll journal report

You can now include Taxable Wages as an additional column(s) in our Payroll Journal Report.  When the new query parameter ‘include_taxable_wages’ is set to true, we’ll include these new columns. Learn more about accessing the payroll journal via API here.

June 10, 2022

Piece rate support in Check API

You can now support payroll for employees who require to be paid at a fixed piece rate for piecework (ie. each unit produced, mileage driven, or times an action is performed), rather than the hours spent completing the work. We’ve added piece rate specific earning types such as `piece`, `rest_and_recovery`, and `non_productive`, which will allow you to compliantly support piece rate pay in your payroll build. 

Learn more about Piece rate here.

June 10, 2022

Previous payroll provider data imports (Beta)

You can now allow companies to import data from their previous payroll provider in Company Onboard. This feature allows you to easily import data like the company’s legal name and EIN, employee demographic data, and year-to-date pay statements and more. This feature is currently in a beta stage — please reach out if you’re interested in learning more!

June 10, 2022

Post-tax deduction overrides

You can now enable users to adjust payroll deductions when a payroll is created or run via our API. This enables you to provide more flexibility around how users manage their own deductions. Learn more about how to override post-tax deductions for a single payroll here.

June 9, 2022

Launch of Check’s Tax Setup API

The Tax Setup API allows you to support better validation of all tax parameters, effective date tax rates, view historically effective-dated tax rates, and see more detailed labels and descriptions of each tax parameter. With this API, you’ll not only be able to collect and update this information but also display this information accurately to your employers and employees.

Learn more about Tax Setup here

June 6, 2022

NY Metro Commuter Transportation Mobility Tax Enhancement

Check has enhanced its support of the New York Metropolitan Commuter Transportation Mobility Tax (MCTMT). In summary, rather than having a large collection at the end of the quarter, the Metro tax will be part of the payroll cash requirement and will be accrued on a payroll-by-payroll basis.

June 2, 2022

New earning type to support paid leave

We now offer the `non_hourly_regular` Earning Type. This category should be used when classifying non-hourly earnings that are taxed like regular earnings. For example, this could be used when tracking the paid family leave for an employee.

May 17, 2022

Opt into faster processing periods with Next Day Pay

You can now offer next day payroll processing periods through Check. Any customer that is eligible for 2-day payments is automatically qualified for Next Day Pay. Next day processing will have an additional fee per next-day payroll per employee. If you’re interested in getting started with Next Day Pay please reach out to your partner success manager, or learn more about our payroll processing periods in the Knowledge Base.

May 13, 2022

38% faster load times in Check Onboard

We’ve made several infrastructure improvements to reduce the time it takes to launch Onboard by 38% (P75). Previously, we would show a loading indicator while we loaded all data across the Onboard app. Now we display parts of the Onboard app as they become ready. Learn more about Check Onboard here.

May 12, 2022

Better mapping of tax setup requirements to filing authorization forms

Previously, we required the tax setup for all jurisdictions to be completed before any filing authorization forms could be signed by companies in our company filing authorization component and Onboard step. Now, filing authorization forms are only blocked by the tax setup details needed by that form. For example, if you have a company in 2 states: CA and NY, you can sign the CA filing authorization forms as soon as you complete the CA tax setup and the NY filing authorization forms as soon as you complete the NY tax setup.

May 12, 2022

Contractor Payments in Console

Contractor Payments now have their own pages in Console, similar to the ones that previously existed for Payroll Items. Accessible from a Payroll Journal, this page will allow you to observe Contractor Payments and their corresponding attempts as well as retry and refund failed payments.

Learn more about Console here.

May 12, 2022

Tip credit support in Check API

The Check API now provides an earning type called `tip_credit_adjustment_to_minimum_wage` to allow you to enter in wages for tip credit workflows properly. Tip credit payroll items can be entered into the Check API using this new earning type and the accompanying `tip_credit_amount` field. Note that `cash_tip` and `paycheck_tip` should be used in conjunction with this earning type if an employee's cash_wage is below the state's typical minimum wage.

Learn more about Tip Credits here.

May 12, 2022

Testing Failure Scenarios in Sandbox

Check’s sandbox environment now provides a mechanism to incur and cause failed payments. Using designated company and employee names, you can simulate payrolls transitioning into a failed payment state. This will allow you to test NSFs, employee closed bank accounts, or a combination of both.

Learn more about testing failure scenarios in Sandbox here.

May 5, 2022

Ohio SUI Power of Attorney Form added‍

Check has added the Ohio State Unemployment Insurance (SUI) Power of Attorney company filing authorization form for Ohio employers. Existing Ohio employers will be put into a “Needs Attention” state until they complete this form but will still be able to run payroll. New Ohio employers will need to sign and submit this form before being able to run payroll. It will be collected as part of Employee Onboard and also be available through our Forms API.

Learn more about the Onboard component here.

May 5, 2022

Emit 'app-close' event when clicking the modal background in Embedded Onboard

You can now emit an ‘app-close’ event whenever onClose is called in Embedded Onboard. Previously, only the `X` button in Embedded Onboard would fire the `app-close` event. Now, clicking the Embedded Onboard modal background will fire this event as well. This fix is part of our continuous process of improving and providing more visibility into the state of our systems.

See our guide to learn more about Onboard.

May 5, 2022

Contractor net pay splits

Contractors are now able to split their pay into multiple bank accounts. This feature is available in Onboard, Console, and the Check API. Contractors can allocate amount-based net pay splits across up to 7 accounts, providing them with more control over how they get paid.

Learn more about net pay splits here.

April 28, 2022

Raw bank account entry for employees and contractors in Onboard

Check Onboard Component

Employees and Contractors using Onboard now have the option to manually enter routing and bank account numbers. Alternatively, they can use Plaid to connect their accounts automatically. 

Learn more about the Onboard component here.

April 25, 2022

POST support for /payroll_items

You can now use the POST endpoint to append a payroll item to larger payrolls. In the past, if you wanted to edit a payroll, you would have to repost the entire payroll. The POST endpoint will make it easier to edit large payrolls if an addition is needed.

Learn more about the payroll object here.

April 25, 2022

LIST support for /payroll_items

You can now use the LIST endpoint in order to gather a list of payroll items for a particular payroll, and it will paginate for 25 items at a time. This will make it easier and more performant for developers to pull payroll items for a given payroll.

Learn more about the payroll object here.

April 21, 2022

Filter documents by jurisdiction in the Company Filing Authorization Component

You can now filter the list of documents in the Company Filing Authorization Component by jurisdiction. To do so, simply filter by jurisdiction in the component creation call.

Learn more about the Company Filing Authorization Component here.

April 21, 2022

Deep-link by jurisdiction in the Company Tax Setup Component

You can now launch the Company Tax Setup Component in the jurisdiction of your choice. To do so, simply specify the jurisdiction you’d like to deep-link using the jurisdiction object.

Learn more about the Company Tax Setup component here.

April 20, 2022

Build custom reports in Console

You can now build custom reports in Console. Use the custom report builder tool to select multiple fields of payroll data — such as employee names, payrolls, work locations, and bank accounts — to build a report for any date range. Some popular reports we have seen include:

- Gross total payrolls by workplace city
- List of employees and their associated bank accounts
- Total company and employee taxes by employee

Learn more about custom reports in Console here.

April 20, 2022

Exponential backoff for Webhook Delivery Retries

In the event of a failed webhook, Check will retry delivery with an exponential backoff starting at 10 seconds with a max period of 6 hours. In the Live environment, we will continue to retry delivery of webhooks over the course of 4 days. 

Learn more about Check webhooks here.

April 18, 2022

Exponential backoff for Webhook Delivery Retries (Sandbox)

In the event of a failed webhook, Check will retry delivery with an exponential backoff starting at 10 seconds with a max period of 6 hours. In Sandbox, Check will only retry delivery 10 times before stopping. 

Learn more about Check webhooks here.

April 7, 2022

Search by payroll ID in Console

You can search by payroll ID in Console. Console will route you to the payroll detail page for that payroll.

April 1, 2022

Child support garnishment remittance is now available in Michigan

Check will now remit payments to the child support agency in Michigan, as well as 22 other US states. For Check to remit the payment, you will need to add the garnishment via the post-tax deduction object and mark ‘managed = true’.

For partners who want to see which other states are supported, see our State Coverage Tracker in the Knowledge Base.

March 31, 2022

Reciprocity now supported via API, Console, and Onboard

Check now supports multi-state employees who have, or desire to opt into, reciprocal agreements between states. Company and Employee “updated” webhooks are triggered whenever an employee opts in or out of Reciprocity.

You can enable Reciprocity in 3 ways:

1) Build your own experience with our API
2) Eligible employees can opt in directly through the Employee Onboard component
3) Your operations team can opt in employees through Console

Read our API guide to learn how Check handles multi-state taxation and reciprocity.

Visit the Knowledge Base to learn more about Withholding Taxes for Multi-state Employees or to see our Partner Guide: Opting into Reciprocity.

March 17, 2022

Support for California 2022 Supplemental Paid Sick Leave

You can now find California 2022 Supplemental Paid Sick Leave as a type under the earnings object. This is in response to California SB 114, which requires employers with 26 or more employees to provide up to 80 hours of COVID-19 Supplemental Paid Sick Leave (SPSL) to employees who are unable to work or telework due to certain reasons related to COVID-19. Check will display additional information on some employee paystubs to maintain compliance with California SB 114.

Learn more about earnings object types here.

For partners interested in learning more about California SB 114 and why we made this change, see our Knowledge Base article.

March 17, 2022

Set monthly benefit contributions in Console

As a fast follow to our Period Amounts release, we have added the ability to set monthly benefit contribution amounts for employers and employees in Console. You will be able to set these amounts by setting `Period` to `Monthly` when creating or editing benefits in Console. 

To learn about how Period Benefits work, see our guide here.

March 16, 2022

Child support garnishments now available in Utah

You can now run payroll for employees with child support garnishments in Utah, as well as 21 other US states. For Check to remit the payment, you will need to enter the garnishment into Check and mark managed = true.

For partners who want to see which other states are supported, see our State Coverage Tracker in the Knowledge Base.

March 10, 2022

Set monthly benefit contributions with Period Amounts

You can now use Period Amounts to set monthly benefit contribution amounts for employers and employees. Check will calculate the appropriate deductions across payrolls based on pay frequency. Previously, you could only set a flat contribution amount or a percentage of wages amount, both of which were directly applied to every payroll.

To learn more, check out our Period Benefits guide here.

March 8, 2022

Termination dates now available for Employees and Contractors

You can now set a termination date for an employee or contractor. Termination dates are available as a new field on Create and Update requests. Termination dates will only display the latest termination date of an employee or contractor.

March 8, 2022

Benefit overrides now available via API

You can now override the contribution amount for a benefit without affecting future contributions. Benefit overrides can be added to a payroll item on payroll creation and updates as well as payroll item updates.

Learn more about Benefit overrides here.

March 1, 2022

February Changelog

February has been a very exciting month at Check! Even with only 28 days to work with, our engineering team was able to make several key additions to Onboard, Console, and our API. This month we released improved payment visibility, failed payment retries, and bank account validation. With the recent announcement of our series C, we are excited for a supercharged year of building to make paying people even simpler!

Get visibility into money movement

For the first time, partners have visibility into the status of money movement within Check. With the new ‘payment’ and ‘payment_attempts’ objects, you can observe payments and their corresponding attempts for completion initiated by Check on behalf of a company directly from the API. For more information, please view the updated documentation here

Retry failed payments

Along with viewing the status and reason for why a payment failed, you are now able to programmatically retry any failed payment with a simple API call or with the click of a button on Console. We will also support programmatic refunds and wires:

  • Refunds: In the event the Company doesn’t want to retry a failed payment and wants to pay the Employee or Contractor manually via a paper check, you’ll have the ability to send the Company a ‘refund’ via Console or our API.
  • Wires: Companies who see a failed ACH debit often prefer sending a wire in time for payday. If your Company would like to do this, you’ll be able to create an expected wire, view the wire details programmatically via our API and Console, and show the status of the wire to your users.

For more information, see our Payments Recovery guide here.



Validate bank accounts

Failed payments are a pain for all of us — they result in significant delays and manual operations. To help avoid failed payments, Check now proactively validates all bank accounts added by your employers, employees, and contractors. If validation fails, we’ll automatically notify you so that you can request your users to update their banking details in time for payday. To ensure account validation does not get in the way of running payroll, bank accounts may be used while validation is in progress. See our Bank Account Validation guide here.

February 1, 2022

January Changelog

January was a rush at Check! Our teams made improvements to our API and core products, Onboard and Console, while also supporting the ongoing effort of year-start and year-end. This month, we’ve released employee pay splits, SSN duplication checks, and company Start Date validation. 

In addition to those features, we’ve also hit embedded payroll support for all 50 states (that’s 50 states, 1267 jurisdictions, and 6829 taxes)! To learn more about this feat, check out our blog post, The Road to 50

Split employee pay into multiple bank accounts  

Check now allows employees to split their pay into multiple bank accounts! This feature is available in Onboard, Console, and the Check API. Employees can split net pay amounts across up to 7 accounts. Here is an example of how a net pay split will work: 

An employee configures their net pay splits as follows: 

  • Priority 1: Wells Fargo checking account ending 4431 
  • Amount: $500
  • Priority 2: PNC savings account ending 2982
  • Amount: $300
  • Priority 3: Capital One savings account ending 6720
  • Amount: Remainder

If the employee receives a net pay of $1000, they’ll receive:

  • Wells Fargo checking (4431)
  • Amount: $500
  • PNC savings (2982)
  • Amount: $300
  • Capital One savings (6720)
  • Amount: $200


See our ‘Net Pay Split’ guide to learn more about employee pay splits.

Prevent employee and contractor SSN duplicates 

We've rolled out SSN Duplicate validation to better support customer tax filings.  We've also updated our API docs to note the duplicate restrictions now in place. At a high level, the duplicate check prohibits:

  • Any single company from having multiple employees with the same SSN.
  • Any single company from having multiple contractors with the same SSN/ITIN.

Please note that a single company can have a contractor and an employee with the same SSN, as a company may pay one person as both a contractor and an employee throughout a tax filing period.

We've added further validation to company Start Dates 

To ensure that all selected company Start Dates are valid banking days, we’ve added validation to only allow users to select valid banking days. Users will see this change in both our API and Console. If a banking holiday is selected, the following error will occur: "Start date {start_date} must be a valid bank date."

December 29, 2021

December Changelog

December is always a busy time of year in the payroll world, but that didn’t stop our team from releasing key features like the Run Payroll Component and support for ‘Applied for’ parameters in Onboard and Console. We're very excited to head into the new year strong, with even more features coming down the pipeline to help you build faster and more elegantly on top of Check.

Happy holidays from the Check team! 

A quick recap of December

  • Launch of the Run Payroll Component
  • Support for ‘Applied For’ status in Onboard and Console
  • Edit support for child support remittances
  • Create new hire contractor reports
  • Add workplaces to contractor payments


Run and preview payrolls using the Run Payroll Component

You can now use the Run Payroll Component to create, edit, preview, and run payroll. This component offers your users an easy way to set up employee pay rates, add earnings, and preview payrolls all in one embeddable flow. 

We’re committed to helping you build a world-class payroll experience. With the use of the Run Payroll Component, you will be able to embed a preview and run payroll flow that is compliant, well-tested, and user-friendly.

To learn more about the Run Payroll Component, and all other Check Components, see our documentation here. If you would like to see how Check Components can help speed up your payroll product build, please reach out.


Mark Console and Onboard parameters as 'Applied For'

We have updated Console and Onboard to allow employers to indicate that certain company parameters are not yet available but have been applied for by the company. This may be useful for a new business that hasn't received its state-specific employer identification number from the state agency.

When marking parameters as “Applied For,” certain state forms may be deferred for signature in Check Onboard and Check Components — this is normal and won't block implementation or payroll.


Edit Child Support Remittance

You can now PATCH the `managed` field on a Post-Tax deduction to `false`, and Check will not include the funds in the `cash_requirement` (found in the Totals object) or attempt to make payment on behalf of the company.

This is for employers who prefer to keep their current process for remitting deductions and not have it paid through Check.

Create new hire contractor reports

Check has added optional fields `dob` and `start_date` to the contractor object and `workplace` to the contractor payments object to facilitate new-hire reporting for contractors.

Add a workplace to a contractor payment

You can now associate a workplace with a contractor payment. This allows Check to complete the appropriate state filing of 1099s for Year-End.

December 1, 2021

November Changelog

We’ve been hard at work this month and are excited to share some of the latest features that shipped at Check! Our team has made many improvements across our platform, specifically around bank account verifications, FEIN validations, benefits support, and Console features. Below is a recap of our November launches.

Launched bank account verifications

To ensure the highest payment success rates, Check now verifies all bank accounts. You can view the status of these verifications via the `status` and `disabled_reason` fields in the bank account object and bank account webhooks.

To learn more, check out our guide on bank account verifications.

Released company W-4 exemptions endpoint

You can now get federal and state withholding exemption status for all employees at a company via this endpoint. With a Form W-4, you are able to determine the amount to withhold from an employee’s paycheck for federal tax purposes. This form needs to be updated annually for employees marked as exempt, so this new report can help you understand which employees to notify.

Please see our reference documentation for more information, and feel free to reach out with any questions.

Released support for effective dated tax withholding settings in Console

This feature provides more visibility and granularity on when settings are effective. For example, tax rates may go into effect only on January 1 of next year. Prior to this launch, users could only define settings once, and needed to make changes to those values on the day they went into effect. Now, users can update current and past setting values as well as create new ones in the future.

As always, you can visit our Console guide for a product overview and can also request an API key to gain full access to Console and its guides.

Added validation for FEIN inputs

We now enforce all FEIN input values to be in the following format: ##-#######. This validation occurs in Console, Check Components, and Check Onboard to ensure consistent and compliant FEIN inputs from your employers.

Added ability to define multiple benefits of the same type for an employee

You can now define multiple benefits of the same type for an employee with non-overlapping effective dates. In addition, you can now define concurrent benefits of the same type for the same employee for Section 125 benefits. For these benefits, a maximum of 10 can exist at the same time for an employee.

For all other benefits, only one benefit of a given type can be effective for a given employee.

November 1, 2021

October Changelog

This month, Check shipped several new features to make building and operating payroll even simpler than before. These features include several new updates to our API, encompassing the Earning Rate API, W2 preview report endpoints, and support for setting an employee’s primary workplace. We’re also excited to announce Console enhancements that will allow your operations team to perform historical payroll audits more efficiently and bulk create up to 25 employees in one fell swoop.

Released Check's Earning Rate API

Developers now have the ability to store employee salary and hourly wages in Check as earning rates. With earning rates, you can calculate the correct gross pay directly via Check’s API when running payroll. This drastically simplifies what developers need to build to launch payroll with Check, saving time and reducing complexity when getting your payroll integration live.

To learn more about Check’s Earning Rates API, check out our guide and our official release blog post.

Launched support for defining benefits at a company level

With the launch of company-level benefits, implementation and benefits administration have never been easier. Prior to this launch, users could only create benefits defined at the employee level. Now, you can define a single company-level benefit and then create multiple employee-level benefits that inherit from that company benefit in a single transaction.

Note: You can still create benefits at the employee level as you’ve done to date — we’ve made this a non-breaking change to our API.

To dive deeper into our company-level benefits, see our reference documentation and Defining Benefits guide.To learn more about Check’s Earning Rates API, check out our guide and our official release blog post.

Added support for Primary Workplaces

Check now supports setting primary workplaces for employees. This enables Check to calculate taxes for employees in multi-state situations more accurately. For employees with a single workplace, their primary workplace will default to that location. For employees who have multiple workplaces, their primary workplace can be assigned via the API or in Console. 

Launched W2 Preview Report Endpoint

With this report, you can get a preview of all of the W2 data for a given company's employees, which will help your team ensure W2 data is correct for end-of-year reporting.

To get more information on the W2 preview report endpoint, see our API reference documentation here.

Launched Payroll Audit revamp and Bulk Employee creation in Console

We are excited to add two new features to Console to support your operations team as they scale your payroll business. 

  • Payroll Audit Revamp
  • Run multiple audits at once
  • Save progress so you can come back later
  • Re-run individual audits with one click
  • Bulk employee creation
  • Employees can be bulk uploaded 25 at a time
  • This removes the manual key-in of information such as employee name, address, date of birth, start date, etc.

Interested in learning more about how Console can help accelerate your payroll product development? See our Console guide for a product overview. You can also request an API key to gain full access to Console and its guides.

October 1, 2021

September Changelog

In September, we enhanced our platform visibility with the addition of accounting and onboard status webhooks, added more functionality to Check Console with custom earning code creation, surfaced more statuses to help with implementation, and released Check Components! Alongside those releases, we also introduced a new API version: v2021-09-02. Below, we will dive into the details of each release.

[BREAKING CHANGE] New API Version v2021-09-02

In the latest API version, we introduced the following changes: 

For a refresher on our API versioning, see our documentation here. If you are a current partner looking to modify your default API version, please reach out and we will help you upgrade.

Released Check Components

We are thrilled to officially launch Check Components: a faster way to build embedded payroll. Check Components are embeddable flows that you can add into your application with a few lines of code. You can pick and choose from a variety of Components that allow you to easily onboard employees, run payroll, generate reports, and set up third-party integrations such as Quickbooks Online. 

To learn more about Components, check out the documentation and our working with check components guide.

Added ability to create custom earning codes in Console

In Console, you now have the ability to create a Custom Earning Code under the Custom Earning Codes tab on the Company page or in the step 3 — add historical payroll section of the Company Setup page. To create a Custom Earning Code, you must set the code name, code status (active or inactive), and which Check earning type the Custom Earning Code maps to. On both pages, you will also have the ability to filter for all active or all inactive Custom Earning Codes.

See our Types of Earnings documentation and our structured earnings guide to dive deeper into Check earning types.

Introducing Implementation and KYB status

Before a company can run its first payroll on Check, it must first be implemented. KYB (know your business) is a step in the company implementation process where Check uses a combination of heuristics and data to determine the risk of managing the company’s payroll. 

We now expose an implementation object through the Company API that contains both the implementation and KYB statuses. You can read more about them here. Additionally, the KYB status is visible through Console in the company info tab.

Added Webhooks for Onboard Status and Accounting Integration Sync Attempts

We will now send you webhook events when an accounting integration sync attempt succeeds or fails. This event will include a serialized version of the SyncAttempt and, if applicable, any relevant failure information. We will send these webhooks with a Check-Topic Header of `accounting_integration_sync_attempt`.

We will also send webhooks whenever an event occurs that may change an entity's onboard status. These events include creating a document or tax form, creating or modifying a workplace or bank account, or updating tax setup parameter settings for companies or employees.

To learn more about Check's webhooks, see our webhooks documentation.

September 1, 2021

August Changelog

We’re excited to announce a handful of features shipped at Check in August! This month, our team was focused on increasing visibility into our platform through more informative warnings, logs, and statuses. These changes will provide our partners with more transparency and allow them to build better and even more delightful experiences for their end customers. 

API logs + guide

In Check Console, you will find a dashboard that allows users to view their requests to Check’s API. You can find this dashboard in the API Logs tab of the Developers section. Access to this view is limited to admin users of Console. For information, see our API logs guide.

Interested in learning more about how Check Console can help accelerate your payroll product development? Request an API key to gain full access to Console and its guides.

Implementation Status object and KYB status

For every company that a partner onboards, implementation is a necessary precursor to running its first payroll. The term “implementation” in payroll refers to the process of loading data for a company into a new payroll system. Check now surfaces the implementation status of a company on the company object. Within the implementation status object, we now surface the KYB (know your business — a compliance verification of the company in question) status, giving you transparency into the  KYB process for the company. Check will also emit webhooks when these statuses are modified. For information, see our Implementation Status guide.

Introducing `partially_applied` warning code for post-tax deductions

Sometimes, an employee may not have enough net pay to cover a post-tax deduction. For example, they may have net pay of $100 but have a miscellaneous post-tax deduction of $200, so we can’t fully apply that deduction. In this case, you would see the `partially_applied` warning code. We would only apply part of the post-tax deduction in the payroll, in this case, $100. This warning code is now part of our currently available warnings found here.

Introducing `exceeds_max_percent` warning reason for child support garnishment

When an employee has a child support garnishment, they have an amount field and a `max_percent` field. The max percent indicates the max amount of disposable earnings that can be garnished. Today, our API automatically enforces this max percent, but we are now showing `exceeds_max_percent` as a warning in this release. You will be able to find this warning with our current list of warnings, and you can read more about our child support garnishment support here.

Company Start Date is now editable in Console (within the current quarter)

External implementation teams can now edit a company’s Start Date in Console. Based on the company’s implementation status (see above), listed below are how partners can change start dates and how Check will automatically be notified of these changes

  • If the company is in `needs_attention`, then the start date will be editable with no notification sent to Check.
  • If the company is in `in_review`, then the start date will be editable, but if it is changed, a notification will be sent to Check for that particular company to inform Check that the start date has changed.
  • If the company is in `complete`, then the start date will be editable, but if it is changed, a notification will be sent to Check for that particular company to inform Check that the start date has changed.
  • Start date cannot be set to a date in the past.
  • Start date cannot be edited outside of the quarter it was initially set.

For more information on Company Start Date, see our reference document. For a more in-depth experience of Console, request an API key here.

The new async paper checks API is live

This API returns a generated URL that partners can poll for paper checks. With this API, you can now get paper checks for an entire payroll in an async manner instead of having to synchronously print paper checks on a per employee basis.

API limit: Note that the maximum number of items/contractors that this API can render for a given payroll is 50. For more information, see our paper checks reference.

Updated semi-monthly pay schedules configuration

Check now supports selecting any pair of dates in a month for semi-monthly pay schedules instead of only supporting the 1st-15th or 15th-end of the month. An optional `second_payday` attribute to the Pay Schedule object has been added. This field should only be used with the semimonthly frequency to specify custom paydays besides the 15th and last day of the month. For more information, see our pay schedules guide.

August 2, 2021

July Changelog

Check added several features to increase the flexibility, compliance, and developer experience of our platform in July. These features include contractor support in Onboard, an improved KYB (know your business) data collection flow in Onboard, and a new status (failed) to our available payroll statuses. These will enable partners to support a wider range of workers, have more confidence in their companies, and have a better line of sight if there are ever any hiccups in their payroll processing.

Added complete contractor support in Onboard

Check now fully supports onboarding contractors through our Onboard product! Just as you could previously collect the necessary information for companies and employees to run payroll through Onboard, contractors in Onboard can now:

  • Link their bank account via Plaid
  • Securely enter their TIN
  • Fill out, sign, and submit a Federal W-9

Like companies and employees, contractor Onboard links can be generated either via Console or the Onboard API endpoint. Updated documentation for our Onboard product, including the contractor functionality, can be found here.

Added additional fields to Onboard

  • Terms of Service: Terms of Service will now be collected as the first step in the Company Onboard process on the welcome screen.
  • Company Details: We now collect additional fields that will improve our KYC/AML processes at Check. The earlier in the company onboarding process that we can collect this information from companies, the faster Check will be able to complete its KYC/AML process to get these customers running payroll. In addition, companies can select an address other than their legal address as their Principal Place of Business, which will appear on employee paystubs.

Added active/inactive flags to Workplace

Workplaces can now be marked as active or inactive via our API. Inactive workplaces may not be assigned to an employee, and active workplaces associated with an employee may not be deactivated. Inactive workplaces are also not considered when determining company onboard status. 

Please see the updated reference and guide for more details.

Added new Failed status to our available Payroll Statuses

The new failed Payroll status is now live and available in production. We’ve also updated our documentation with details about this new status as well as a new diagram to illustrate a Payroll’s lifecycle.

Enabled monthly, quarterly, and annual frequencies through pay schedule API

Added user/group management support in Console

We’re excited to launch user and group management in Console! This will enable Console admins to create new users & restrict their visibility on a company-level basis.

Added modification of name and metadata in Pay Schedule

Payment method in paystubs JSON response

You can now see whether an employee was paid as `direct_deposit` or `manual` in the JSON body for the paystubs endpoint. This added granularity allows you to inspect paystubs by payment method to provide more flexibility in how you choose to leverage this endpoint. Learn more about paystubs here.