Conciliação

GETGET /user/transactions/user/transactions POSTPOST /user/report/user/report Paginação Multi-tenant

Listagem em tempo real

Para conferir transações ao vivo (dashboard, conciliação de dia anterior):

curl "https://api.payzu.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"

Detalhes dos filtros em GET /user/transactions.

Filtros úteis

Filtro	Descrição
`clientReference`	Encontra a transação correspondente ao seu pedido.
`status`	CSV: `COMPLETED,PENDING`. Aceita múltiplos.
`type`	CSV: `DEPOSIT,WITHDRAW,COMMISSION`.
`dateFrom` / `dateTo`	Janela temporal (ISO 8601).
`endToEndId`	Identificador único Bacen.
`document`, `name`	Filtros por pagador. `document` apenas dígitos (11 ou 14).
`virtualAccount`	Filtro por tenant (multi-loja).
`limit`, `page`	Paginação. `limit` máximo 100.

Detalhe de uma transação

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

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

Relatório assíncrono

Para janelas grandes (mês, ano), use fluxo em 3 passos.

Solicitar geração

POST /user/report.

curl -X POST https://api.payzu.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"]
  }'

A resposta inclui o id do job.

Acompanhar status

GET /user/report/{id}.

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

Baixar quando pronto

POST /user/report/{id}/download retorna URL assinada de curta duração para baixar o CSV.

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

Estratégia recomendada

Identifique cada cobrança/saque com clientReference, esse é seu identificador, não dependa só do id da PayZu.
Use callbacks como fonte primária, não polle.
Reconciliação diária via relatório: pegue o CSV do dia anterior e cruze com seu DB. Detecta callback perdido.
Guarde endToEndId, útil para rastrear no Bacen em caso de disputa.

Saldos

Para conferir saldo disponível antes de pagar:

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

Veja GET /user/balance.

Conciliação

On this page