{
"trigger": {
"eventId": "5fd45e70-0676-419e-ba44-91f23cb71da9",
"eventType": "payperiod.payperiodstatus.insert",
"eventTimeStamp": "04/06/2026 22:07:04"
},
"payload": [
{
"payPeriod": [
{
"payPeriodId": "30AF9044-3E27-4D01-9938-DAA958C88D8D",
"payPeriod": "09/01/2025 - 09/30/2025",
"deadLineToRunPayroll": "2025-09-26",
"PayPeriodStatus": "new",
"total": 3120,
"debitAmount": 678.29,
"employeeTaxSum": 393.4,
"employerTaxSum": 284.89,
"isProcessed": false,
"payDate": "2025-09-30",
"payBeginDate": "2025-09-01",
"payEndDate": "2025-09-30",
"workerType": {
"workerType": "W2"
},
"payPeriodType": {
"payPeriodType": "Regular"
},
"payrollLineItems": [],
"companyId": "EB45E206-5E50-4079-8B41-04C05E4C5338"
}
]
}
]
}Pay Period
Pay Period Status
Emitted when a pay period is created or its status changes.
Events
payperiod.payperiodstatus.insert— emitted when a pay period is created. The initialPayPeriodStatusisnew.payperiod.payperiodstatus.update— emitted when an existing pay period changes tosubmitted,cancelled,inProcess,processed,failed,returned, orskipped.
When payroll initiation is cancelled, the status moves from submitted to cancelled; it does not return to new.
WEBHOOK
payPeriodStatus
{
"trigger": {
"eventId": "5fd45e70-0676-419e-ba44-91f23cb71da9",
"eventType": "payperiod.payperiodstatus.insert",
"eventTimeStamp": "04/06/2026 22:07:04"
},
"payload": [
{
"payPeriod": [
{
"payPeriodId": "30AF9044-3E27-4D01-9938-DAA958C88D8D",
"payPeriod": "09/01/2025 - 09/30/2025",
"deadLineToRunPayroll": "2025-09-26",
"PayPeriodStatus": "new",
"total": 3120,
"debitAmount": 678.29,
"employeeTaxSum": 393.4,
"employerTaxSum": 284.89,
"isProcessed": false,
"payDate": "2025-09-30",
"payBeginDate": "2025-09-01",
"payEndDate": "2025-09-30",
"workerType": {
"workerType": "W2"
},
"payPeriodType": {
"payPeriodType": "Regular"
},
"payrollLineItems": [],
"companyId": "EB45E206-5E50-4079-8B41-04C05E4C5338"
}
]
}
]
}Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Headers
Unix timestamp, in seconds, used when verifying the webhook signature.
Pattern:
^\d+$Example:
"1767725956"
Rollfi webhook signature containing the key ID, algorithm, and signature value.
Example:
"kid=rollfi-webhook-key-01,alg=RS256,v1=eyJhbGciOiJSUzI1NiJ9"
Body
application/json
Response
200
Pay period status event accepted successfully.