All documentation · People operations

Payroll and payslips

Define free-form salary structures with earning and deduction components, set a base currency, run payroll for a month, and generate downloadable payslips for every employee.

9 min read · Reviewed

Clyentra's payroll is a calculator you define, not a tax engine you inherit. You describe someone's pay as a list of components — some add, some subtract — and Clyentra does the arithmetic, applies attendance, and produces a payslip. Understanding that one design decision makes everything else in this article obvious.

There is no built-in statutory tax engine: Clyentra does not compute income tax withholding, social insurance, or pension contributions for any jurisdiction. It has no tax tables and it does not file anything on your behalf. What it does is apply exactly the components you define. If a deduction should be on a payslip, you put it there — as a component with an amount. Read this paragraph twice before you run your first payroll.

The two views

Open /hr/hr-payroll. The screen is titled Payroll — "View your salary details and check payslips" — and what you see depends on who you are.

TabWhat it shows
My PayslipsEvery payslip generated for you, one per completed payroll run
Salary StructureYour current compensation, broken down by component

Admins get one extra thing: a Run Payroll button in the header. It takes you to HR configurations, on the payroll tab — which is where the machinery actually lives.

The salary structure model, in full

A salary structure is assigned to one employee, is effective from a date, and holds a list of components. Every component has exactly four properties:

PropertyWhat it is
NameWhat appears on the payslip — "Base Salary", "Health Insurance"
CodeA short machine-friendly key, auto-derived from the name (you can override it)
AmountA number, in the structure's base currency
Component TypeEarning (+) or Deduction (-)

That is the entire model. There are no formulas, no percentages-of-other-components, no jurisdiction rules hiding behind it. Earnings are summed, deductions are summed, and net pay is the difference. If you can express someone's pay as a list of names and amounts, Clyentra can pay it.

A worked example

For a team in Portland, Toronto or Berlin, a structure might look like this:

NameCodeComponent TypeAmount
Base Salarybase_salaryEarning (+)6,000
Housing Allowancehousing_allowanceEarning (+)800
Transport Allowancetransport_allowanceEarning (+)200
Health Insurancehealth_insuranceDeduction (-)300
Retirement Contributionretirement_contributionDeduction (-)400
Income Tax Withholdingincome_tax_withholdingDeduction (-)1,500

Earnings total 7,000. Deductions total 2,200. Net pay is 4,800. Those numbers are yours — the tax withholding figure came from your payroll provider or your accountant, not from Clyentra.

Assign a structure

In HR configurations, the Salary structures tab — "Manage employee compensation plans and component breakdowns" — lists your employees down the left. Press Assign structure.

  1. Select Employee. Search by name or code. A structure belongs to exactly one person.
  2. Set Effective From. When this compensation starts. Effective To (Optional) is what you set when it ends — leave it empty and the structure is the active one.
  3. Set the Base Currency. It defaults to your organization's currency — USD, CAD, EUR, GBP. Every amount in this structure is denominated in it.
  4. Build the components. Press Add Component for each one. Fill in Name (the Code auto-fills from it), Amount, and Component TypeEarning (+) or Deduction (-). The accordion header previews each component as + 6,000 USD or - 300 USD, so you can see the sign at a glance.
  5. Press Create structure. A component with no name or no code is dropped silently on save — fill both in, or it will not exist.

Each structure carries its own currency: Base Currency is set per structure, not per organization. A team spread across the US, Canada and Germany can hold USD, CAD and EUR structures side by side, and each payslip is denominated in the currency of the structure that produced it.

Reading the structure panel

Select an employee and you get two things worth knowing about.

The Active net pay card shows earnings minus deductions for the structure currently in force, with a bar splitting the two and separate Earnings and Deductions totals underneath. It is the number the employee actually receives, and it is the one to sanity-check before you run anything.

Compensation history is a timeline of every structure that person has ever had, newest at the top, each badged Active or Archived. Expand any entry with View components breakdown and you see exactly what that structure paid — every component, with its code and its signed amount.

Raises are new structures, not edits: To give someone a raise, set Effective To on the current structure and assign a new one starting the next day. Do not overwrite the amounts on the old structure — if you do, you destroy the record of what they used to earn, and Compensation history becomes a history of nothing.

Run payroll

In HR configurations, the Payroll tab — "Create, process, and review payroll periods" — is where a month becomes money.

  1. Press New run. The form is headed New payroll run.
  2. Set the period. A Month (1–12) and a Year. Add Notes if you need to — the placeholder reads "Optional payroll notes" — and it is where you record why this run was unusual.
  3. Press Create payroll run. The run is created as a draft. Nothing has been calculated yet, and nothing has been sent.
  4. Press Process. The Process button appears on a draft run and only on a draft run. This is the step that does the work.

A run has three statuses: draft → processing → completed. When it completes, a payslip exists for every employee in the run, and the run's detail panel lists them under Employee payslips with each person's working days, days present, leave taken, gross, deductions and net.

Draft is your only chance to look: A run sits in draft until you press Process, and that gap is the review window. Once it is completed, payslips exist and people can see them. Check the Active net pay on your structures and the attendance figures for the month before you process, not after.

Attendance feeds payroll

Every payslip carries total working days, days present and leave taken. Clyentra pulls those from the attendance and leave records for the period — which means a month of missing check-ins produces a payslip somebody argues with.

Chase the regularization requests and the pending leave approvals before you process the run. Fixing attendance after a payslip exists is a much longer conversation. See attendance-and-leave.

The payslip

On My Payslips, every completed run you were part of appears in the left rail as a period — March 2026, with its net pay beside it. Select one and the payslip opens.

It shows the period and when it was processed, the attendance block (total working days, days present, leave taken), and the money: total earnings (gross), total deductions, and net take-home. Press Download Payslip and Clyentra generates a PDF — the document you send to a landlord or a bank, with the amount rendered in words as well as figures. The button confirms with Downloaded when it lands.

The Salary Structure tab shows the same employee their current structure: gross monthly payout, then Earnings and Deductions side by side, each component with its name, its code and its amount, and a total for each column.

When an employee sees nothing

Two empty states, two different causes:

What they seeWhat it means
"Your salary structures are not configured. Contact your HR administrator."No structure has been assigned to them. Nothing else can happen until it is
"No payslips available" — "Your processed payslips will appear here once payroll runs are completed."They have a structure, but no payroll run has been processed yet

The order that works: Employees exist → attendance and leave are clean for the period → every employee has an active salary structure → create the run → check it while it is a draft → Process. Skip a step and you will find out which one you skipped from the person whose payslip is wrong.

Questions people ask

Does Clyentra calculate income tax for me?

No. Clyentra has no statutory tax engine of any kind — no tax tables, no jurisdiction rules, no filings. It applies exactly the components you define. If income tax withholding, health insurance or a retirement contribution should appear on a payslip, you add it as a component of type Deduction (-) with an amount you calculated elsewhere.

What exactly is a salary component?

Four things and nothing more: a Name, a Code, an Amount, and a Component Type which is either Earning (+) or Deduction (-). Earnings are summed, deductions are summed, and net pay is the difference. There are no formulas and no percentage-of-another-component rules.

Can different employees be paid in different currencies?

Yes. Base Currency is a property of each salary structure, not of the organization, though it defaults to the organization's currency. A structure in USD, one in CAD and one in EUR can sit side by side, and each payslip is denominated in the currency of the structure that produced it.

How do I give someone a raise?

Set Effective To on their current structure, then assign a new structure starting the following day. Do not edit the amounts on the old one — that would erase what they used to earn. Done correctly, Compensation history shows both, badged Archived and Active.

What are the payroll run statuses?

draft → processing → completed. A new run is a draft until you press Process. That draft window is your only opportunity to check the period and the structures before payslips exist — use it.

Why does my payslip show fewer days present than I worked?

Because payslips are built from attendance records. Total working days, days present and leave taken all come from the attendance and leave data for that period. If a check-in is missing, raise a regularization request — ideally before payroll is processed. See attendance-and-leave.

How do I get a payslip as a PDF?

Open My Payslips, select the period from the left rail, and press Download Payslip. Clyentra generates a PDF with the amount in words as well as figures — the version you send to a bank or a landlord.

An employee says they can't see their salary structure. Why?

They have not been assigned one. They will be seeing: "Your salary structures are not configured. Contact your HR administrator." Go to HR configurations → Salary structures, select them, and press Assign structure. Nothing else in payroll works for that person until this exists.

Every Clyentra guide