Mark payroll run as paid

POST/payroll/runs/{id}/mark-paid

Marks an approved payroll run as fully paid, indicating all payment batches have been processed and disbursed. This is a terminal state — once marked paid, the run cannot be modified.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the approved run.

Request body

Content type application/json.

Field	Type	Required	Description
payment_reference	string	No	Optional bank or payment processor reference for the disbursement. Max length: 255

Example

{
  "payment_reference": "BATCH_BANKTRANSFER_20260430_001"
}

Responses

200 Run marked as paid

409 Run is not in "approved" status

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/runs/{id}/mark-paid" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"payment_reference": "BATCH_BANKTRANSFER_20260430_001"}'