Announcing earning codes

March 30, 2021
Ian Zapolsky

Head of Partner Engineering

Ian Zapolsky

Employers running payroll often want the flexibility to customize labels for certain earnings, in such a way that will flow through to their employees’ paystubs. For example, imagine a restaurant that wants to pay employees for waiting tables and washing dishes. The restaurant might want those paystubs to reflect those details. In fact, ever since Check’s first API users began building on top of our platform, the desire to add custom earning codes has resurfaced again and again. So we're excited to announce the Earning Codes API!

Before Earning Codes, our initial support for custom labels on earnings took a “stateless” approach, meaning users could pass us a description and code field with each earning, which we would use for aggregation on the paystub.

However, there were a couple downsides of this approach. First, it pushed the complexity of maintaining the list of eligible descriptions and codes for a company onto our partners. Second, it prevented Check from actually knowing what earning codes were eligible for a company, which impacted our ability to accurately ingest historical payroll data with a multitude of earning codes, as well as provide high-quality accounting integrations.

With the Earning Code API, partners can create a list of earning codes for each company, which can then be used during the creation of earnings for that company’s employees. The Earning Codes API is now live and ready to be used by all our partners. We plan to deprecate the “code” field on the payroll item earning object in future API versions.

For a glimpse at Earning Codes in action, take our restaurant example. You can now create two earning codes in Check’s API:

These two requests will return Earning Code objects with IDs. These can then be listed like so:

These earning codes can now be used within the earnings for employees on a payroll item, instead of a type, code, and description. Whereas before one might have had to send:

Now, with earning codes, you can send:

More from the Check blog

May 16, 2023

The Invention of the Employee Time Clock

The employee time clock was invented by Willard Le Grand Bundy in Auburn, New York in 1888. The value of the clock was immediately obvious to employers, who had the unenviable task of monitoring the arrival and departure times of dozens or hundreds of employees every day to determine how much they should be paid at the end of each pay period. The device's major innovation over a standard clock was that it allowed for a piece of paper, or a card, to be fed into a slot, and when it hit a contact at the back of the slot, the current date and time information would be stamped onto the card.

Read more >

Could payroll protect your platform during a recession?

When times get tough, businesses are forced to cut costs by eliminating services that they deem non-essential. However, payroll is not one of those services. As businesses tighten their budgets, they are less likely to cancel their payroll service because it’s critical for any business to offer timely and accurate payments to their workers. Said differently, everyone loves (and needs) payday!

Read more >