Start by checking whether the payroll branch is supported
The calculator does not choose a tax code from personal circumstances. It starts only after the reader has confirmed M or M SL and entered gross PAYE income for one of the four supported pay frequencies.
KiwiSaver is also an explicit input. No employee deduction, 3.5%, 4%, 6%, 8% and 10% are supported choices. The 3% choice is available only when a valid temporary rate reduction has already been confirmed.
| Input decision | Supported choices | What Wage101 does not decide |
|---|---|---|
| Main-income tax code | M or M SL | Which code is correct for the worker or whether a special certificate applies. |
| Pay frequency | Weekly, fortnightly, four-weekly or monthly | How to convert an irregular, changed-period or unsupported payment. |
| Employee KiwiSaver | None; 3.5%, 4%, 6%, 8% or 10%; confirmed temporary 3% | Membership, eligibility or temporary-reduction approval. |
| Payment type | Ordinary employee gross pay for one period | Extra pay, termination pay, schedular payments or payroll filing treatment. |
Follow the supported deductions without counting ACC twice
The calculator annualises the entered period pay, applies the reviewed income-tax and ACC calculation, and converts the result back to the selected period using the production truncation sequence. The displayed PAYE amount already includes the ACC earnersโ levy.
When M SL is selected, the standard student-loan deduction is calculated above the reviewed threshold for that pay period. The explicit employee KiwiSaver amount is then added to PAYE and any supported student-loan amount before total deductions are subtracted from gross pay.
| Line | Role in the result | Interpretation boundary |
|---|---|---|
| Income-tax component | Tax portion separated for explanation | It is already part of PAYE including ACC. |
| ACC component | Employee earnersโ levy portion | Do not add it again to the PAYE figure. |
| Student loan | Standard M SL period deduction | M returns zero; special rates and certificates are excluded. |
| Employee KiwiSaver | Gross period pay multiplied by the explicit supported rate | Employer KiwiSaver and ESCT are outside this take-home result. |
NZ$2,000 fortnightly produces NZ$1,587 in the production example
The calculator-aligned scenario uses NZ$2,000 of fortnightly gross pay, confirmed tax code M and a 3.5% employee KiwiSaver rate. M means that no student-loan deduction is included in this example.
| Step or output | Exact value | What the row means |
|---|---|---|
| Annualised taxable income | NZ$52,000 | NZ$2,000 multiplied by 26 fortnightly periods and processed by the calculator. |
| Income-tax component | NZ$308.00/fortnight | Income-tax portion of the supported PAYE result. |
| ACC component | NZ$35.00/fortnight | Shown separately for explanation but already inside PAYE. |
| PAYE including ACC | NZ$343.00/fortnight | NZ$308 income tax plus NZ$35 ACC; do not add ACC again. |
| Student-loan deduction | NZ$0.00 | The confirmed code is M rather than M SL. |
| Employee KiwiSaver | NZ$70.00 | NZ$2,000 multiplied by the confirmed 3.5% rate. |
| Total supported deductions | NZ$413.00 | NZ$343 PAYE including ACC plus NZ$70 KiwiSaver. |
| Bounded take-home pay | NZ$1,587.00/fortnight | Gross pay less the supported deductions in this scenario. |
M and M SL answer different confirmed payroll scenarios
M SL adds the standard main-income student-loan calculation to the M payroll path. Wage101 does not infer an SL code from the presence of a loan, and it does not support special deduction rates, exemptions or compulsory extra repayments.
Changing the code is therefore not a sensitivity experiment. It represents a different payroll record that should be selected only after checking current Inland Revenue guidance or the workerโs confirmed tax-code information.
Know why a payslip can differ from the bounded estimate
The calculator deliberately covers a smaller set of branches than a payroll system. A difference may reflect an unsupported tax code, certificate, irregular payment, other deduction, prior adjustment or employer payroll record rather than an arithmetic error in the visible scenario.
- No ME/IETC, secondary, tailored, ND, NSW, CAE, EDW, WT or other tax-code branch.
- No daily, three-weekly, half-monthly, changed-period or irregular-pay calculation.
- No special student-loan rate, exemption, compulsory extra or voluntary repayment.
- No extra pay, bonus, termination, child support, benefit, reimbursement or payroll correction.
- No employer KiwiSaver, ESCT, payroll filing, annual reconciliation, refund or final liability.
Use the current ordinary-payroll source, not a lump-sum shortcut
The load-bearing evidence is Inland Revenueโs Payroll Calculations and Business Rules Specification for 1 April 2026 to 31 March 2027, with the supported PAYE-table and component evidence recorded in Wage101โs policy dependency.
A lump-sum-payment guide and a minimum-wage page do not support this ordinary-payroll calculation. Recheck the official specification, tax-code guidance and calculator methodology when the period, code or payment type falls outside the bounded branch.
How the New Zealand Take-Home Pay Calculator calculation works
takeHomePayPerPeriod = round to cents(grossPayPerPeriod โ totalDeductionsPerPeriod)
- takeHomePayPerPeriod
- Bounded take-home pay
- grossPayPerPeriod
- Gross pay per period
- payFrequency
- Pay frequency
- taxCode
- Main-income tax code
- kiwiSaverRate
- Employee KiwiSaver rate
The calculator and article use this relationship consistently; the article does not reimplement the calculation.
totalDeductionsPerPeriod = round to cents(payeIncludingAccPerPeriod + studentLoanPerPeriod + kiwiSaverEmployeePerPeriod)
- totalDeductionsPerPeriod
- Total supported deductions
- grossPayPerPeriod
- Gross pay per period
- payFrequency
- Pay frequency
- taxCode
- Main-income tax code
- kiwiSaverRate
- Employee KiwiSaver rate
The calculator and article use this relationship consistently; the article does not reimplement the calculation.
payeIncludingAccPerPeriod = truncate to cents((annualIncomeTax + annualAccEarnersLevy) รท 52 ร 52 รท periodsPerYear)
- payeIncludingAccPerPeriod
- PAYE including ACC levy
- grossPayPerPeriod
- Gross pay per period
- payFrequency
- Pay frequency
- taxCode
- Main-income tax code
- kiwiSaverRate
- Employee KiwiSaver rate
The calculator and article use this relationship consistently; the article does not reimplement the calculation.
studentLoanPerPeriod = taxCode is M SL ? truncate to cents(max(0, truncate grossPayPerPeriod to whole dollars โ periodThreshold) ร 0.12) : 0
- studentLoanPerPeriod
- Student loan deduction
- grossPayPerPeriod
- Gross pay per period
- payFrequency
- Pay frequency
- taxCode
- Main-income tax code
- kiwiSaverRate
- Employee KiwiSaver rate
The calculator and article use this relationship consistently; the article does not reimplement the calculation.
kiwiSaverEmployeePerPeriod = truncate to cents(grossPayPerPeriod ร explicitKiwiSaverRate)
- kiwiSaverEmployeePerPeriod
- Employee KiwiSaver deduction
- grossPayPerPeriod
- Gross pay per period
- payFrequency
- Pay frequency
- taxCode
- Main-income tax code
- kiwiSaverRate
- Employee KiwiSaver rate
The calculator and article use this relationship consistently; the article does not reimplement the calculation.
NZ$2,000 fortnightly on M with an explicit 3.5% KiwiSaver rate.
Inputs used in the New Zealand Take-Home Pay Calculator worked example
| Input | Entered value | What it represents | Source class |
|---|---|---|---|
| Gross pay per period | 2,000 NZD/pay period | Gross PAYE income for the selected supported period; the visible maximum is safe for every supported frequency. | user assumption |
| Pay frequency | Fortnightly | Choose a supported payroll frequency. | user record |
| Main-income tax code | M | Choose M or M SL only. | user record |
| Employee KiwiSaver rate | 3.5% | Choose no deduction or an explicit supported rate. | user record |
Choose the right New Zealand Take-Home Pay Calculator basis or mode
| Choice | How to use it |
|---|---|
| Weekly | Choose a supported payroll frequency. |
| Fortnightly | Choose a supported payroll frequency. |
| Four-weekly | Choose a supported payroll frequency. |
| Monthly | Choose a supported payroll frequency. |
| Choice | How to use it |
|---|---|
| M | Choose M or M SL only. |
| M SL | Choose M or M SL only. |
| Choice | How to use it |
|---|---|
| No employee deduction | Choose no deduction or an explicit supported rate. |
| 3% temporary reduction confirmed | Choose no deduction or an explicit supported rate. |
| 3.5% | Choose no deduction or an explicit supported rate. |
| 4% | Choose no deduction or an explicit supported rate. |
| 6% | Choose no deduction or an explicit supported rate. |
| 8% | Choose no deduction or an explicit supported rate. |
| 10% | Choose no deduction or an explicit supported rate. |
Worked example: New Zealand Take-Home Pay Calculator
The calculator normalizes the inputs above, applies Bounded take-home pay, and returns the outputs below. The displayed result is therefore reproducible in the linked calculator.
| Measure | Result | Interpretation |
|---|---|---|
| Bounded take-home pay | 1,587 NZD/pay period | Gross less PAYE including ACC, supported student loan and explicit KiwiSaver. |
| Total supported deductions | 413 NZD/pay period | Sum of supported calculator deductions. |
| PAYE including ACC levy | 343 NZD/pay period | Annualised PAYE and ACC converted to the selected period. |
| Student loan deduction | 0 NZD/pay period | M SL deduction above the official period threshold. |
| Employee KiwiSaver deduction | 70 NZD/pay period | Gross pay multiplied by the explicit supported rate. |
Interpret the result and test Gross pay per period
- Bounded take-home pay: 1,587 NZD/pay period. Gross less PAYE including ACC, supported student loan and explicit KiwiSaver.
- Total supported deductions: 413 NZD/pay period. Sum of supported engine deductions.
- PAYE including ACC levy: 343 NZD/pay period. Annualised PAYE and ACC converted to the selected period.
- Student loan deduction: 0 NZD/pay period. M SL deduction above the official period threshold.
- Employee KiwiSaver deduction: 70 NZD/pay period. Gross pay multiplied by the explicit supported rate.
| Result | Baseline | Changed-input scenario | How to read it |
|---|---|---|---|
| Bounded take-home pay | 1,587 NZD/pay period | 1,723.72 NZD/pay period | Gross less PAYE including ACC, supported student loan and explicit KiwiSaver. |
| Total supported deductions | 413 NZD/pay period | 476.28 NZD/pay period | Sum of supported calculator deductions. |
| PAYE including ACC levy | 343 NZD/pay period | 399.28 NZD/pay period | Annualised PAYE and ACC converted to the selected period. |
| Student loan deduction | 0 NZD/pay period | 0 NZD/pay period | M SL deduction above the official period threshold. |
| Employee KiwiSaver deduction | 70 NZD/pay period | 77 NZD/pay period | Gross pay multiplied by the explicit supported rate. |
Checks that are specific to New Zealand Take-Home Pay Calculator
- The worked example uses the same shared-work-logic engine as the interactive planner.
- Unsupported eligibility, policy branches and out-of-range assumptions fail closed.
- Result cards, trace, CSV, PDF and methodology bind to named engine result fields.
What this New Zealand Take-Home Pay Calculator guide includes and excludes
- The selected M or M SL code is correct.
- KiwiSaver membership/rate and any temporary reduction are confirmed.
Sources and method boundary
- www.ird.govt.nz guidance used for the reviewed local boundary โ www.ird.govt.nz (accessed 2026-07-28): Reviewed 2026-07-28 against the IRD 2026โ27 payroll specification effective 1 April 2026 and its scoped payroll pages; unsupported tax codes and deductions fail closed.
- www.ird.govt.nz guidance used for the reviewed local boundary โ www.ird.govt.nz (accessed 2026-07-28): Reviewed 2026-07-28 against the IRD 2026โ27 payroll specification effective 1 April 2026 and its scoped payroll pages; unsupported tax codes and deductions fail closed.
- www.ird.govt.nz guidance used for the reviewed local boundary โ www.ird.govt.nz (accessed 2026-07-28): Reviewed 2026-07-28 against the IRD 2026โ27 payroll specification effective 1 April 2026 and its scoped payroll pages; unsupported tax codes and deductions fail closed.
- www.ird.govt.nz guidance used for the reviewed local boundary โ www.ird.govt.nz (accessed 2026-07-28): Reviewed 2026-07-28 against the IRD 2026โ27 payroll specification effective 1 April 2026 and its scoped payroll pages; unsupported tax codes and deductions fail closed.
- New Zealand Take-Home Pay Calculator methodology โ Wage101 (accessed 2026-07-28): Canonical formulas, units, validation, calculator behavior and limitations.