Announcing earning codes

March 30, 2021
Ian Zapolsky

Head of Partner Engineering

by 
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

February 20, 2024

Embedded Payroll for vertical Workforce Management Startups

We’re doubling down on our commitment to startups as we continue to deliver on our mission of making paying people simple, across platforms of all sizes and verticals.

Read more >

February 15, 2024

Voices of Check: Head of Education Tisha Winfield

Tisha Winfield is Check's Head of Education. She joined Check in 2020 as the 13th hire. Since, she has had an immense impact on building of both the company and the culture.

Read more >