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
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"
Response
200
Pay period status event accepted successfully.