kepa
Reconciliation/performReconciliation

Close the Day

Settle pending transactions and reset the till.

POST/v1/reconciliation
Run end-of-day reconciliation. When closeDay is true the terminal settles all pending transactions with the acquirer, resets running totals, and returns a summary of the settlement period. When false, the call returns current totals without settling — useful as a pre-close dry run.

Request body

application/json

closeDaybooleanrequired

When true, settle and reset. When false, dry run.

Example: true

Response

application/json

statusenumrequired

Reconciliation outcome.

SUCCESSFAILEDPARTIAL
totalsobjectrequired

The TransactionTotals at the moment of settlement.

timestampstring · ISO 8601required

Reconciliation timestamp.

Example: "2026-03-28T23:00:00Z"

commerce-api/openapi.yaml · performReconciliation

POSTLocal
http://terminal:8443/v1/reconciliation
Request
curl http://terminal:8443/v1/reconciliation \
  -H "X-Api-Key: $ATLAS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "closeDay": true }'
Response
{
  "status": "SUCCESS",
  "totals": {
    "saleCount": 47,
    "saleAmount": 328750,
    "refundCount": 2,
    "refundAmount": 5000,
    "voidCount": 1,
    "voidAmount": 1200,
    "preAuthCount": 3,
    "preAuthAmount": 45000,
    "currency": "NZD"
  },
  "timestamp": "2026-03-28T23:00:00Z"
}