Settlement

Batch settlement and settlement report generation. Requires the reports:read scope.

POST/api/v1/{system}/settle🔒 reports:read

Trigger end-of-day batch settlement. Sends a settlement report to the specified email.

Auth: Bearer JWT

Request Body

FieldTypeRequiredDescription
branchIdlongYesBranch user ID
emailstringYesEmail for settlement report
timezonestringYesIANA timezone (e.g. Pacific/Auckland)
⚠️ Live testing disabled for this endpoint — it modifies data. Use curl or the SDK against your sandbox.
POST/api/v1/{system}/settlementReport🔒 reports:read

Generate a settlement report for a date range without triggering settlement.

Auth: Bearer JWT

Request Body

FieldTypeRequiredDescription
branchIdlongYesBranch user ID
startDateLocalDateYesReport start date
endDateLocalDateYesReport end date
SandboxCalls go to https://payus.co.nz

Authentication