initiatePayroll
Payroll
initiatePayroll
Starts payroll calculation and processing for a specific pay period.
Pre-Execution Checklist
✅ All payroll data successfully imported, including hours, deductions, additional compensations etc.
✅ Bank account verified.
✅ The funding source has the required funds.
✅ All employee information (addresses, tax details) up to date.
Process Flow:
- Validation: Checks all requirements
- Recalculation: Computes wages, taxes, deductions to ensure up to date numbers before payroll runs
- Processing: Executes payments, payroll is
inProcess - Confirmation: Sends notifications
Notes:
- If payroll is initated before the
deadlineToRunPayrollthe payPeriod becomessubmittedand will automatically process on the deadline. - If
runNow: trueis included in the request, or the date is past thedeadlineToRunPayrollthe payroll processes immediately, skipping thesubmittedstatus, and the payDate is brought forward. - If the company bank account is linked with plaid (includes balance checks) and does not have the required funds to cover payroll, the submission will be unsuccessful.
- For more information regarding the payroll process please refer to the Payroll Processing guide.
POST
initiatePayroll
Documentation Index
Fetch the complete documentation index at: https://developer.rollfi.xyz/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
