{
  "$comment": "Machine-readable companion to https://valem.run/calculators/hong-kong/net-salary. Formula, inputs, outputs, engine-verified test vectors, cited sources and the re-runnable Valem ModelSpec behind the page.",
  "url": "https://valem.run/calculators/hong-kong/net-salary",
  "dataUrl": "https://valem.run/calculators/hong-kong/net-salary.json",
  "license": {
    "name": "CC BY 4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Hong Kong salaries tax model by Valem (https://valem.run/calculators/hong-kong/net-salary), CC BY 4.0.",
    "note": "Covers the model — the expression of each rule and the arrangement of the catalog. The rates and thresholds themselves are law and are not licensed by anyone; the cited sources are where they come from."
  },
  "verificationUrl": "https://valem.run/calculators/hong-kong/net-salary/verify",
  "country": "hong-kong",
  "countryName": "Hong Kong",
  "formula": "net-salary",
  "formulaName": "Salaries tax",
  "title": "Salaries Tax Calculator Hong Kong 2026/27 — MPF & take-home",
  "answer": "Your Hong Kong take-home pay is your salary minus your 5% MPF contribution (between the $7,100 and $30,000 monthly levels) and salaries tax, which is the lower of progressive rates on income after allowances and the 15% standard rate on income before them.",
  "lang": "en",
  "currency": "HKD",
  "taxYear": "2026/27",
  "verification": {
    "claim": "internal-consistency",
    "statement": "The Valem engine reproduces this model's stated formula through 6 self-test cases (below, and re-runnable against the spec). That asserts internal consistency, NOT that the formula matches current law — the cited sources are the evidence for that, and carry the date each was last checked.",
    "selfTestCases": 6,
    "ratesAreIllustrative": false,
    "sourcesCheckedOn": "2026-10-12"
  },
  "sources": [
    {
      "label": "Inland Revenue Department, A guide to Salaries Tax (pam39e) — progressive and two-tiered standard rates, the 2026/27 basic and married person’s allowances and the MPF deduction, with worked 2026/27 examples",
      "url": "https://www.ird.gov.hk/eng/pdf/pam39e.pdf",
      "checked": "2026-10-12"
    },
    {
      "label": "Inland Revenue Department, 2026-27 Budget — Tax Measures (FAQ): allowances from 2026/27, including the child allowance of $140,000 for each of the 1st to 9th child",
      "url": "https://www.ird.gov.hk/eng/faq/budget2026_27.htm",
      "checked": "2026-10-12"
    },
    {
      "label": "MPFA, Mandatory contributions — employees: 5% of relevant income between the minimum and maximum relevant income levels",
      "url": "https://www.mpfa.org.hk/en/mpf-system/mandatory-contributions/employees",
      "checked": "2026-10-12"
    }
  ],
  "terminalOutput": "netAnnual",
  "headlineOutput": "netAnnual",
  "inputs": [
    {
      "name": "grossAnnual",
      "type": "number",
      "label": "Gross annual salary (HKD)",
      "format": "currency",
      "minimum": 0
    },
    {
      "name": "household",
      "type": "string",
      "label": "Allowance"
    },
    {
      "name": "children",
      "type": "number",
      "label": "Children you claim for",
      "minimum": 0,
      "maximum": 9
    }
  ],
  "outputs": [
    {
      "name": "mpfEmployee",
      "type": "number",
      "label": "Employee MPF (5%, capped)",
      "format": "currency",
      "formula": "($m := $n(grossAnnual) / 12; $round(($m < $const.mpfMinRelevantMonthly ? 0 : ($m < $const.mpfMaxRelevantMonthly ? $m : $const.mpfMaxRelevantMonthly) * $const.mpfRate) * 12, 2))"
    },
    {
      "name": "mpfDeduction",
      "type": "number",
      "formula": "mpfEmployee < $const.mpfDeductionCap ? mpfEmployee : $const.mpfDeductionCap"
    },
    {
      "name": "incomeAfterDeductions",
      "type": "number",
      "label": "Net total income (after the MPF deduction)",
      "format": "currency",
      "formula": "($v := $n(grossAnnual) - mpfDeduction; $v < 0 ? 0 : $v)"
    },
    {
      "name": "allowances",
      "type": "number",
      "label": "Allowances",
      "format": "currency",
      "formula": "(household = 'marriedSoleEarner' ? $const.marriedAllowance : $const.basicAllowance) + $floor($n(children)) * $const.childAllowance"
    },
    {
      "name": "chargeableIncome",
      "type": "number",
      "label": "Net chargeable income",
      "format": "currency",
      "formula": "($v := incomeAfterDeductions - allowances; $v < 0 ? 0 : $v)"
    },
    {
      "name": "taxProgressive",
      "type": "number",
      "label": "Tax at progressive rates",
      "format": "currency",
      "formula": "$round($bandedCharge(chargeableIncome, [{\"upTo\": $const.bandWidth, \"rate\": $const.rateBand1}, {\"upTo\": $const.bandWidth * 2, \"rate\": $const.rateBand2}, {\"upTo\": $const.bandWidth * 3, \"rate\": $const.rateBand3}, {\"upTo\": $const.bandWidth * 4, \"rate\": $const.rateBand4}, {\"upTo\": null, \"rate\": $const.rateTop}]), 2)"
    },
    {
      "name": "taxStandard",
      "type": "number",
      "label": "Tax at standard rate",
      "format": "currency",
      "formula": "$round($bandedCharge(incomeAfterDeductions, [{\"upTo\": $const.standardTierThreshold, \"rate\": $const.standardRate}, {\"upTo\": null, \"rate\": $const.standardRateUpper}]), 2)"
    },
    {
      "name": "salariesTax",
      "type": "number",
      "label": "Salaries tax (the lower)",
      "format": "currency",
      "formula": "taxProgressive < taxStandard ? taxProgressive : taxStandard"
    },
    {
      "name": "netMonthly",
      "type": "number",
      "label": "Net / month",
      "format": "currency",
      "formula": "$round(($n(grossAnnual) - mpfEmployee - salariesTax) / 12, 2)"
    },
    {
      "name": "netAnnual",
      "type": "number",
      "label": "Net / year (after MPF & salaries tax)",
      "format": "currency",
      "formula": "$round($n(grossAnnual) - mpfEmployee - salariesTax, 2)"
    }
  ],
  "testCases": [
    {
      "description": "H1 IRD pam39e Q2: $480,000 with the basic allowance — $35,890 at progressive rates",
      "given": {
        "grossAnnual": 480000,
        "household": "single",
        "children": 0
      },
      "expect": {
        "mpfEmployee": 18000,
        "incomeAfterDeductions": 462000,
        "chargeableIncome": 317000,
        "taxProgressive": 35890,
        "taxStandard": 69300,
        "salariesTax": 35890,
        "netAnnual": 426110
      }
    },
    {
      "description": "H2 IRD pam39e Q5: same income, married person’s allowance — $12,080",
      "given": {
        "grossAnnual": 480000,
        "household": "marriedSoleEarner",
        "children": 0
      },
      "expect": {
        "chargeableIncome": 172000,
        "salariesTax": 12080
      }
    },
    {
      "description": "H3 one child allowance",
      "given": {
        "grossAnnual": 480000,
        "household": "single",
        "children": 1
      },
      "expect": {
        "chargeableIncome": 177000,
        "salariesTax": 12780
      }
    },
    {
      "description": "H4 $20,000 a month: MPF $1,000 a month, tax $2,980",
      "given": {
        "grossAnnual": 240000,
        "household": "single",
        "children": 0
      },
      "expect": {
        "mpfEmployee": 12000,
        "chargeableIncome": 83000,
        "salariesTax": 2980,
        "netAnnual": 225020
      }
    },
    {
      "description": "H5 below the $7,100 minimum relevant income: no employee MPF and no tax",
      "given": {
        "grossAnnual": 84000,
        "household": "single",
        "children": 0
      },
      "expect": {
        "mpfEmployee": 0,
        "salariesTax": 0,
        "netAnnual": 84000
      }
    },
    {
      "description": "H6 $6m: the two-tiered standard rate is lower than progressive",
      "given": {
        "grossAnnual": 6000000,
        "household": "single",
        "children": 0
      },
      "expect": {
        "taxProgressive": 974290,
        "taxStandard": 907120,
        "salariesTax": 907120,
        "netAnnual": 5074880
      }
    }
  ],
  "spec": {
    "id": "net-salary-hong-kong",
    "version": "1.0.0",
    "schema": {
      "type": "object",
      "properties": {
        "grossAnnual": {
          "type": "number",
          "minimum": 0
        },
        "household": {
          "type": "string"
        },
        "children": {
          "type": "number",
          "minimum": 0,
          "maximum": 9
        },
        "mpfEmployee": {
          "type": "number",
          "readOnly": true
        },
        "mpfDeduction": {
          "type": "number",
          "readOnly": true
        },
        "incomeAfterDeductions": {
          "type": "number",
          "readOnly": true
        },
        "allowances": {
          "type": "number",
          "readOnly": true
        },
        "chargeableIncome": {
          "type": "number",
          "readOnly": true
        },
        "taxProgressive": {
          "type": "number",
          "readOnly": true
        },
        "taxStandard": {
          "type": "number",
          "readOnly": true
        },
        "salariesTax": {
          "type": "number",
          "readOnly": true
        },
        "netMonthly": {
          "type": "number",
          "readOnly": true
        },
        "netAnnual": {
          "type": "number",
          "readOnly": true
        }
      }
    },
    "constants": {
      "basicAllowance": 145000,
      "marriedAllowance": 290000,
      "childAllowance": 140000,
      "bandWidth": 50000,
      "rateBand1": 0.02,
      "rateBand2": 0.06,
      "rateBand3": 0.1,
      "rateBand4": 0.14,
      "rateTop": 0.17,
      "standardRate": 0.15,
      "standardRateUpper": 0.16,
      "standardTierThreshold": 5000000,
      "mpfRate": 0.05,
      "mpfMinRelevantMonthly": 7100,
      "mpfMaxRelevantMonthly": 30000,
      "mpfDeductionCap": 18000
    },
    "library": {
      "layers": [
        {
          "id": "statutory",
          "define": "(\n  /* Shared statutory helpers — the canonical copy (docs/sandbox/d8-statutory-families.md §5.4).\n     DO NOT EDIT A SPEC'S INLINED COPY. Edit this file and run `npm run sync:helpers`; a vitest\n     assertion and a Java assertion both require every inlined copy to be byte-identical to this one.\n\n     Why inlined rather than referenced: the `library` section's `ref` form — a library shared\n     between models — is still proposed, gated on the model-references design (see\n     ../../../../docs/design/library/jsonata-library.md). Inlining keeps each spec self-contained,\n     which is what lets `#e=` embedding, `#share=` import and MCP forking work with no resolver.\n\n     TWO TRAPS, both of which fail SILENTLY and both of which bit during the debt-payoff build:\n\n       1. A library function sees ONLY its arguments. It cannot read the consuming document — not\n          through a bare field name, not through `$`, not through `$$`. Everything these helpers\n          need is passed in. (`$const` is late-bound and so would resolve, but relying on it would\n          couple a shared helper to one spec's constant names.)\n       2. ONE null member wrecks a whole aggregate, and the two engines disagree about how. The JS\n          reference implementation THROWS (\"Argument 1 of function sum must be an array of\n          numbers\"); the Java port can instead yield null for the entire aggregate. Neither gives a\n          partial total, and the null-yielding form is the dangerous one because it is silent. So\n          callers coerce with `$n()` below before aggregating, which makes the behaviour identical\n          in both engines — measured, not assumed: see helpers.test.ts.\n\n       3. A PATH STEP DIRECTLY ON A CALL RESULT RETURNS NOTHING in the Java engine. This matters for\n          every caller of $amortize, which is the one helper here returning an object:\n\n              $amortize(p, r, n, 0).months            -> empty in Java, 360 in JS.  WRONG\n              ($a := $amortize(p, r, n, 0); $a.months) -> 360 in both.               RIGHT\n\n          Bind the result to a variable, then step into it. The JS reference accepts both forms, so\n          this is invisible until the page is served by the real engine, and it fails as a blank\n          field rather than an error. Measured with a probe, not inferred — the field simply does\n          not appear. */\n\n  /* Number coercion with an explicit zero default. The guard against trap 2. */\n  $n := function($v) { $v = null or $not($exists($v)) ? 0 : $number($v) };\n\n  /* ISO date -> its year / month / day parts. String slicing rather than $fromMillis formatting:\n     these are statutory dates (\"2026-04-06\"), and a timezone-sensitive round-trip through millis\n     can shift the day, which silently moves a service anniversary across a band boundary. */\n  $isoY := function($d) { $number($substring($d, 0, 4)) };\n  $isoM := function($d) { $number($substring($d, 5, 2)) };\n  $isoD := function($d) { $number($substring($d, 8, 2)) };\n\n  /* Whole years of completed service between two ISO dates. Counts an anniversary as reached only\n     when the month-and-day has arrived, which is what \"completed years of service\" means in every\n     severance statute — not a 365.25-day division, whose drift crosses a 5-year band boundary in\n     the wrong direction roughly one year in four. */\n  $yearsBetween := function($from, $to) { (\n    $y := $isoY($to) - $isoY($from);\n    $beforeAnniversary := $isoM($to) < $isoM($from)\n      or ($isoM($to) = $isoM($from) and $isoD($to) < $isoD($from));\n    $beforeAnniversary ? $y - 1 : $y\n  ) };\n\n  /* Whole completed months between two ISO dates, same convention. */\n  $monthsBetween := function($from, $to) { (\n    $m := ($isoY($to) - $isoY($from)) * 12 + ($isoM($to) - $isoM($from));\n    $isoD($to) < $isoD($from) ? $m - 1 : $m\n  ) };\n\n  /* Inclusive count of days between two ISO dates — both endpoints counted, because a leave year\n     runs from its first day to its last and an employee present on both is present for both.\n     Pro-rata accrual is then $proRataDays(a, b) / $proRataDays(yearStart, yearEnd). */\n  $proRataDays := function($from, $to) {\n    ($toMillis($to) - $toMillis($from)) / 86400000 + 1\n  };\n\n  /* Progressive charge across bands. `$bands` is ordered lowest-first, each {\"upTo\": n, \"rate\": r};\n     the final band's `upTo` is omitted or null to mean \"no ceiling\". Each band's rate applies ONLY\n     to the slice of the amount inside it — the single most common error in a hand-written bracket\n     walk is applying the top rate to the whole amount. Returns 0 for a non-positive amount. */\n  $bandedCharge := function($amount, $bands) { (\n    $a := $n($amount);\n    $a <= 0 ? 0 : $reduce($bands, function($acc, $band) { (\n      $ceiling := $exists($band.upTo) and $band.upTo != null ? $band.upTo : $a;\n      $top := $ceiling < $a ? $ceiling : $a;\n      $slice := $top - $acc.floor;\n      {\n        \"floor\": $top > $acc.floor ? $top : $acc.floor,\n        \"charge\": $acc.charge + ($slice > 0 ? $slice * $n($band.rate) : 0)\n      }\n    ) }, {\"floor\": 0, \"charge\": 0}).charge\n  ) };\n\n  /* Clamp into [floor, cap]. Either bound may be omitted (null) to leave that side open — a benefit\n     with a cap and no floor is as common as one with both. */\n  $clampFloorCap := function($value, $floor, $cap) { (\n    $v := $n($value);\n    $withFloor := $exists($floor) and $floor != null and $v < $floor ? $floor : $v;\n    $exists($cap) and $cap != null and $withFloor > $cap ? $cap : $withFloor\n  ) };\n\n  /* Level annuity payment for a principal over `$months` at `$annualRatePct` nominal, compounded\n     monthly. Falls back to straight-line division at a zero rate, where the standard formula\n     divides by zero. */\n  $annuityPayment := function($principal, $annualRatePct, $months) { (\n    $p := $n($principal);\n    $m := $n($months);\n    $i := $n($annualRatePct) / 1200;\n    $m <= 0 ? 0 : ($i = 0 ? $p / $m : $p * $i * $power(1 + $i, $m) / ($power(1 + $i, $m) - 1))\n  ) };\n\n  /* Amortisation schedule: one row per month until the balance clears or `$months` is reached.\n     Returns {\"payment\", \"months\", \"totalInterest\", \"schedule\": [{month, interest, principal,\n     balance}]}. `$extra` is an optional monthly overpayment.\n\n     A real month-by-month fold rather than a closed form, because an overpayment changes every\n     later row — the same reason debt-payoff simulates. Bounded by `$months`, so it always\n     terminates. */\n  $amortize := function($principal, $annualRatePct, $months, $extra) { (\n    $i := $n($annualRatePct) / 1200;\n    $pay := $annuityPayment($principal, $annualRatePct, $months) + $n($extra);\n    $r := $reduce([1..$n($months)], function($acc, $month) {\n      $acc.balance <= 0 ? $acc : (\n        /* The running balance is kept UNROUNDED and only the emitted row is rounded. Rounding the\n           balance each month instead accumulates drift: at 200,000 over 360 months it left 2.83\n           still owing in the final row, which would break the \"final balance is zero\" invariant\n           (§7.3) and look to a reader like the schedule does not pay the loan off. Lenders compute\n           on the exact balance and adjust the last payment, which is what this does. */\n        $interest := $acc.balance * $i;\n        $due := $acc.balance + $interest < $pay ? $acc.balance + $interest : $pay;\n        $principalPart := $due - $interest;\n        $balance := $acc.balance - $principalPart;\n        {\n          \"balance\": $balance,\n          \"totalInterest\": $acc.totalInterest + $interest,\n          \"schedule\": $append($acc.schedule, [{\n            \"month\": $month,\n            \"interest\": $round($interest, 2),\n            \"principal\": $round($principalPart, 2),\n            \"balance\": $round($balance, 2)\n          }])\n        }\n      )\n    }, {\"balance\": $n($principal), \"totalInterest\": 0, \"schedule\": []});\n    {\n      \"payment\": $round($pay, 2),\n      \"months\": $count($r.schedule),\n      \"totalInterest\": $round($r.totalInterest, 2),\n      \"schedule\": [$r.schedule]\n    }\n  ) };\n\n  [\"n\", \"isoY\", \"isoM\", \"isoD\", \"yearsBetween\", \"monthsBetween\", \"proRataDays\",\n   \"bandedCharge\", \"clampFloorCap\", \"annuityPayment\", \"amortize\"]\n)\n"
        }
      ]
    },
    "defaultValues": [
      {
        "path": "$",
        "expr": "{ 'grossAnnual': 480000, 'household': 'single', 'children': 0 }"
      }
    ],
    "derivations": [
      {
        "path": "$.mpfEmployee",
        "expr": "($m := $n(grossAnnual) / 12; $round(($m < $const.mpfMinRelevantMonthly ? 0 : ($m < $const.mpfMaxRelevantMonthly ? $m : $const.mpfMaxRelevantMonthly) * $const.mpfRate) * 12, 2))"
      },
      {
        "path": "$.mpfDeduction",
        "expr": "mpfEmployee < $const.mpfDeductionCap ? mpfEmployee : $const.mpfDeductionCap"
      },
      {
        "path": "$.incomeAfterDeductions",
        "expr": "($v := $n(grossAnnual) - mpfDeduction; $v < 0 ? 0 : $v)"
      },
      {
        "path": "$.allowances",
        "expr": "(household = 'marriedSoleEarner' ? $const.marriedAllowance : $const.basicAllowance) + $floor($n(children)) * $const.childAllowance"
      },
      {
        "path": "$.chargeableIncome",
        "expr": "($v := incomeAfterDeductions - allowances; $v < 0 ? 0 : $v)"
      },
      {
        "path": "$.taxProgressive",
        "expr": "$round($bandedCharge(chargeableIncome, [{\"upTo\": $const.bandWidth, \"rate\": $const.rateBand1}, {\"upTo\": $const.bandWidth * 2, \"rate\": $const.rateBand2}, {\"upTo\": $const.bandWidth * 3, \"rate\": $const.rateBand3}, {\"upTo\": $const.bandWidth * 4, \"rate\": $const.rateBand4}, {\"upTo\": null, \"rate\": $const.rateTop}]), 2)"
      },
      {
        "path": "$.taxStandard",
        "expr": "$round($bandedCharge(incomeAfterDeductions, [{\"upTo\": $const.standardTierThreshold, \"rate\": $const.standardRate}, {\"upTo\": null, \"rate\": $const.standardRateUpper}]), 2)"
      },
      {
        "path": "$.salariesTax",
        "expr": "taxProgressive < taxStandard ? taxProgressive : taxStandard"
      },
      {
        "path": "$.netMonthly",
        "expr": "$round(($n(grossAnnual) - mpfEmployee - salariesTax) / 12, 2)"
      },
      {
        "path": "$.netAnnual",
        "expr": "$round($n(grossAnnual) - mpfEmployee - salariesTax, 2)"
      }
    ],
    "constraints": [],
    "viewDefinition": {
      "renderer": "builtin",
      "defaultView": "main",
      "views": [
        {
          "id": "main",
          "label": "Take-home pay",
          "layout": "vertical",
          "components": [
            {
              "id": "gross",
              "type": "numericField",
              "label": "Gross annual salary (HKD)",
              "bind": "$.grossAnnual",
              "helperText": "Assumed paid evenly across the year, which is how the MPF levels are applied month by month."
            },
            {
              "id": "household",
              "type": "selectField",
              "label": "Allowance",
              "bind": "$.household",
              "helperText": "A married person whose spouse has no assessable income (or who elects joint assessment) takes the married person’s allowance instead of the basic one.",
              "options": [
                {
                  "value": "single",
                  "label": "Basic allowance (single, or spouse taxed separately)"
                },
                {
                  "value": "marriedSoleEarner",
                  "label": "Married person’s allowance (spouse has no income)"
                }
              ]
            },
            {
              "id": "children",
              "type": "numericField",
              "label": "Children you claim for",
              "bind": "$.children"
            },
            {
              "id": "tiles",
              "type": "group",
              "layout": "horizontal",
              "components": [
                {
                  "id": "netM",
                  "type": "statTile",
                  "label": "Net / month",
                  "bind": "$.netMonthly",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "id": "netY",
                  "type": "statTile",
                  "label": "Net / year (after MPF & salaries tax)",
                  "bind": "$.netAnnual",
                  "format": "currency",
                  "currency": "HKD"
                }
              ]
            },
            {
              "id": "breakdown",
              "type": "keyValueList",
              "label": "Annual breakdown",
              "items": [
                {
                  "label": "Gross",
                  "bind": "$.grossAnnual",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "label": "Employee MPF (5%, capped)",
                  "bind": "$.mpfEmployee",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "label": "Net total income (after the MPF deduction)",
                  "bind": "$.incomeAfterDeductions",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "label": "Allowances",
                  "bind": "$.allowances",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "label": "Net chargeable income",
                  "bind": "$.chargeableIncome",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "label": "Tax at progressive rates",
                  "bind": "$.taxProgressive",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "label": "Tax at standard rate",
                  "bind": "$.taxStandard",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "label": "Salaries tax (the lower)",
                  "bind": "$.salariesTax",
                  "format": "currency",
                  "currency": "HKD"
                },
                {
                  "label": "Net",
                  "bind": "$.netAnnual",
                  "format": "currency",
                  "currency": "HKD"
                }
              ]
            },
            {
              "id": "note",
              "type": "staticText",
              "text": "Year of assessment 2026/27 (1 April 2026 – 31 March 2027). Salaries tax is the LOWER of progressive rates (2/6/10/14/17%) on income after deductions and allowances, and the standard rate (15% on the first $5 million, 16% above) on income after deductions with no allowances. The employee’s 5% MPF contribution applies only between the $7,100 and $30,000 monthly relevant-income levels and is deductible up to $18,000. Salaries tax is assessed after the year, not withheld from pay. Any one-off tax reduction for 2026/27 would be announced in the following February’s Budget and is not included. Estimate, not tax advice."
            },
            {
              "id": "sources",
              "type": "sourceList",
              "label": "Sources",
              "layers": 2,
              "items": [
                {
                  "label": "Inland Revenue Department, A guide to Salaries Tax (pam39e) — progressive and two-tiered standard rates, the 2026/27 basic and married person’s allowances and the MPF deduction, with worked 2026/27 examples",
                  "url": "https://www.ird.gov.hk/eng/pdf/pam39e.pdf",
                  "date": "2026-10-12",
                  "covers": [
                    "basicAllowance",
                    "marriedAllowance",
                    "bandWidth",
                    "rateBand1",
                    "rateBand2",
                    "rateBand3",
                    "rateBand4",
                    "rateTop",
                    "standardRate",
                    "standardRateUpper",
                    "standardTierThreshold",
                    "mpfDeductionCap"
                  ]
                },
                {
                  "label": "Inland Revenue Department, 2026-27 Budget — Tax Measures (FAQ): allowances from 2026/27, including the child allowance of $140,000 for each of the 1st to 9th child",
                  "url": "https://www.ird.gov.hk/eng/faq/budget2026_27.htm",
                  "date": "2026-10-12",
                  "covers": [
                    "childAllowance"
                  ]
                },
                {
                  "label": "MPFA, Mandatory contributions — employees: 5% of relevant income between the minimum and maximum relevant income levels",
                  "url": "https://www.mpfa.org.hk/en/mpf-system/mandatory-contributions/employees",
                  "date": "2026-10-12",
                  "covers": [
                    "mpfRate",
                    "mpfMinRelevantMonthly",
                    "mpfMaxRelevantMonthly"
                  ]
                }
              ]
            }
          ]
        }
      ]
    },
    "tests": [
      {
        "description": "H1 IRD pam39e Q2: $480,000 with the basic allowance — $35,890 at progressive rates",
        "given": {
          "$.grossAnnual": 480000,
          "$.household": "single",
          "$.children": 0
        },
        "expect": {
          "$.mpfEmployee": 18000,
          "$.incomeAfterDeductions": 462000,
          "$.chargeableIncome": 317000,
          "$.taxProgressive": 35890,
          "$.taxStandard": 69300,
          "$.salariesTax": 35890,
          "$.netAnnual": 426110
        }
      },
      {
        "description": "H2 IRD pam39e Q5: same income, married person’s allowance — $12,080",
        "given": {
          "$.grossAnnual": 480000,
          "$.household": "marriedSoleEarner",
          "$.children": 0
        },
        "expect": {
          "$.chargeableIncome": 172000,
          "$.salariesTax": 12080
        }
      },
      {
        "description": "H3 one child allowance",
        "given": {
          "$.grossAnnual": 480000,
          "$.household": "single",
          "$.children": 1
        },
        "expect": {
          "$.chargeableIncome": 177000,
          "$.salariesTax": 12780
        }
      },
      {
        "description": "H4 $20,000 a month: MPF $1,000 a month, tax $2,980",
        "given": {
          "$.grossAnnual": 240000,
          "$.household": "single",
          "$.children": 0
        },
        "expect": {
          "$.mpfEmployee": 12000,
          "$.chargeableIncome": 83000,
          "$.salariesTax": 2980,
          "$.netAnnual": 225020
        }
      },
      {
        "description": "H5 below the $7,100 minimum relevant income: no employee MPF and no tax",
        "given": {
          "$.grossAnnual": 84000,
          "$.household": "single",
          "$.children": 0
        },
        "expect": {
          "$.mpfEmployee": 0,
          "$.salariesTax": 0,
          "$.netAnnual": 84000
        }
      },
      {
        "description": "H6 $6m: the two-tiered standard rate is lower than progressive",
        "given": {
          "$.grossAnnual": 6000000,
          "$.household": "single",
          "$.children": 0
        },
        "expect": {
          "$.taxProgressive": 974290,
          "$.taxStandard": 907120,
          "$.salariesTax": 907120,
          "$.netAnnual": 5074880
        }
      }
    ]
  }
}