This object forms the basis of the Employees payment.

Name / Description Type / Format Example
period string "Custom" "Monthly" "FourWeekly" "Fortnightly" "Weekly" "Daily"
Indicates whether to use first, second, third (etc) PaySchedule for this PayPeriod.
integer int32 0
The amount the Employee is regularly paid each period
number double 0.0
basis string "Hourly" "Daily" "Monthly"
nationalMinimumWage boolean true
This property is irrelevant if the basis is Monthly.
But if the basis is Daily or Hourly then this property sets how many days/hours the employee should be paid for in the period.
number double 0.0
This property is used to calculate values for PayCodes that are set as multiples of
the employees base hourly rate. Eg Overtime.
If this is set as zero then we'll attempt to calculate a value based on the other fields
number double 0.0
Automatically reduce the PayAmount when the Employee has Leave that is either Not Paid or has Statutory Pay.
Can only be set to True if the Basis is Monthly (ie, employee is not paid an hourly or daily rate).
If set to false then you must manually reduce their payment to reflect any Leave
boolean true
method string "Cash" "Cheque" "Credit" "DirectDebit"
If you want the Employees pay to be allocated to a code other than BASIC, specify it here
string "string"
If you don't want negative PAYE values when the Gross pay is zero, set this to true
boolean true
mileageVehicleType string "Car" "Motorcycle" "Cycle"
The number of miles to pay for as Mileage Allowance Payments
integer int32 0
taxAndNi TaxAndNi {TaxAndNi}
fpsFields FpsFields {FpsFields}
These are used to make additions/deductions to the pay for this Employee.
You do not need to include Pension, Tax, NI, Loan Repayments, etc as these will all be automatically created.
PayLine[] {PayLine}
tags string[]
  "period": "Custom",
  "ordinal": 0,
  "payAmount": 0.0,
  "basis": "Hourly",
  "nationalMinimumWage": true,
  "payAmountMultiplier": 0.0,
  "baseHourlyRate": 0.0,
  "autoAdjustForLeave": true,
  "method": "Cash",
  "payCode": "string",
  "withholdTaxRefundIfPayIsZero": true,
  "mileageVehicleType": "Car",
  "mapsMiles": 0,
  "taxAndNi": {
    "niTable": "string",
    "secondaryClass1NotPayable": true,
    "postgradLoan": true,
    "postgraduateLoanStartDate": "2022-05-23",
    "postgraduateLoanEndDate": "2022-05-23",
    "studentLoan": "None",
    "studentLoanStartDate": "2022-05-23",
    "studentLoanEndDate": "2022-05-23",
    "taxCode": "string",
    "week1Month1": true
  "fpsFields": {
    "offPayrollWorker": true,
    "irregularPaymentPattern": true,
    "nonIndividual": true,
    "hoursNormallyWorked": "LessThan16"
  "regularPayLines": [
      "value": 0.0,
      "rate": 0.0,
      "multiplier": 0.0,
      "description": "string",
      "attachmentOrderId": "string",
      "pensionId": "string",
      "leaveId": "string",
      "leaveStatutoryDaysPaid": 0.0,
      "leaveStatutoryWeeksPaid": 0.0,
      "code": "string",
      "tags": [
  "tags": [
Contained in Models
Consumed by Operations
Apply PayOptions
Returned by Operations

- none -

Getting Started Understanding PayOptions
Getting Started The Ordinal property
Getting Started Using Tags