Reconciliation

GETGET /user/transactions/user/transactions POSTPOST /user/report/user/report Pagination Multi-tenant

Real-time listing

To check live transactions (dashboard, previous-day reconciliation):

curl "https://api.saq.processamento.com/v1/user/transactions?dateFrom=2025-08-01&dateTo=2025-08-31&page=1&limit=100" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Filter details in GET /user/transactions.

Useful filters

Filter	Description
`clientReference`	Finds the transaction matching your order.
`status`	CSV: `COMPLETED,PENDING`. Accepts multiple values.
`type`	CSV: `DEPOSIT,WITHDRAW,COMMISSION`.
`dateFrom` / `dateTo`	Time window (ISO 8601).
`endToEndId`	Unique Bacen identifier.
`document`, `name`	Payer filters. `document` digits only (11 or 14).
`virtualAccount`	Tenant filter (multi-store).
`limit`, `page`	Pagination. `limit` max 100.

Single transaction detail

curl "https://api.saq.processamento.com/v1/user/transactions/SAQ2025..." \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Schema in GET /user/transactions/{id}.

Asynchronous report

For large windows (month, year), use a 3-step flow.

Request generation

POST /user/report.

curl -X POST https://api.saq.processamento.com/v1/user/report \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "dateFrom": "2025-01-01",
    "dateTo": "2025-12-31",
    "status": ["COMPLETED"],
    "type": ["DEPOSIT", "WITHDRAW"]
  }'

The response includes the job id.

Track status

GET /user/report/{id}.

curl "https://api.saq.processamento.com/v1/user/report/JOB_ID" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Download when ready

POST /user/report/{id}/download returns a short-lived signed URL to download the CSV.

curl -X POST "https://api.saq.processamento.com/v1/user/report/JOB_ID/download" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Recommended strategy

Identify each charge/withdrawal with clientReference — that is your identifier, don't rely solely on Saq's id.
Use callbacks as the primary source, don't poll.
Daily reconciliation via report: pull the previous day's CSV and cross-check with your DB. Detects missed callbacks.
Store endToEndId — useful to trace at Bacen in case of dispute.

Balances

To check available balance before paying out:

curl https://api.saq.processamento.com/v1/user/balance \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

See GET /user/balance.

Reconciliation

On this page