Skip to main content
The STL API requires the complete payroll context for the employee’s paycheck — the same inputs provided to STE at calculation time. This context enables STL to accurately trace and explain each tax withheld.
Full Payroll ContextSupply the full payCalc context for the paycheck, including all wages and all jurisdictions. Partial context — limited to only the tax being explained — will result in inaccurate explanations.
The method for capturing and supplying payroll context depends on your STE implementation:
  • API: capture and save the flat employee payCalc object
  • On-premise SDK: enable PayCalc session recording

STE JSON API

The payCalc request object contains all context required by STL. Persist the full request payload at calculation time — in a database, cache, or alongside the paycheck record — so it is available when a tax explanation is requested. Pass the stored object as the paycalc_context field in the /explain request body. See how to do this in the full workflow.

STE On-Premise SDK

On-premise clients must enable PayCalc Session Recording to capture STE calculations in a replayable format. See PayCalc Session Recording for configuration, storage guidance, and API reference.