kepa
Reconciliation/getTransactionTotals

Running Transaction Totals

Live totals for the current settlement period.

GET/v1/totals
Get the running totals for the current settlement period — sale count and amount, refunds, voids, pre-auths. Use it to balance the till before closing, surface a live dashboard, or sanity-check before triggering reconciliation. Pass a currency to scope to a single currency on multi-currency terminals.
QUERY PARAMETERS
currencystring

Filter totals by ISO 4217 currency code.

Example: "NZD"

Response

application/json

saleCountintegerrequired

Number of completed sale transactions.

Example: 47
saleAmountintegerrequired

Total sale amount in minor units.

Example: 328750
refundCountintegerrequired

Number of completed refunds.

Example: 2
refundAmountintegerrequired

Total refund amount in minor units.

Example: 5000
voidCountintegerrequired

Number of voided transactions.

Example: 1
voidAmountintegerrequired

Total voided amount in minor units.

Example: 1200
preAuthCountintegerrequired

Number of pre-authorizations.

Example: 3
preAuthAmountintegerrequired

Total pre-auth amount in minor units.

Example: 45000
currencystringrequired

ISO 4217 currency code.

Example: "NZD"

commerce-api/openapi.yaml · getTransactionTotals

GETLocal
http://terminal:8443/v1/totals
Request
curl http://terminal:8443/v1/totals?currency=NZD \
  -H "X-Api-Key: $ATLAS_API_KEY"
Response
{
  "saleCount": 47,
  "saleAmount": 328750,
  "refundCount": 2,
  "refundAmount": 5000,
  "voidCount": 1,
  "voidAmount": 1200,
  "preAuthCount": 3,
  "preAuthAmount": 45000,
  "currency": "NZD"
}