Conciliação

Bata suas transações com as nossas todo dia, consultando os movimentos em tempo real ou puxando relatórios de períodos longos, e use a sua referência própria pra casar cada pagamento com o pedido certo.

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.

Os filtros de listagem (clientReference, status, type, janela por dateFrom/dateTo, endToEndId, document/name, virtualAccount) estão documentados em Paginação · Filtros disponíveis.

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

Nesta página