Reconcile payment transaction

POST/payroll/payment-transactions/{id}/reconcile

Marks an individual payment transaction within a batch as reconciled, linking it to a bank statement or payment processor confirmation. Use during month-end reconciliation.

Request

Path parameters

Name	Type	Required	Description
id	integer	Yes	The numeric ID of the payment transaction to reconcile.

Request body

Content type application/json.

Field	Type	Required	Description
bank_reference	string	No	Bank or payment processor transaction reference. Max length: 255
settled_at	string (date-time)	No	Timestamp when the transaction was confirmed as settled.

Example

{
  "bank_reference": "GHB-TXN-2026-0042",
  "settled_at": "2026-04-30T23:59:00Z"
}

Responses

200 Transaction reconciled

404 Transaction not found

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/payroll/payment-transactions/{id}/reconcile" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"bank_reference": "GHB-TXN-2026-0042", "settled_at": "2026-04-30T23:59:00Z"}'