PayZu Conta HubConta
Listar o extrato
Confira, lançamento por lançamento, tudo o que mexeu no saldo disponível da conta.
Liste os lançamentos
bash
curl --request GET \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/statement?limit=20&dateFrom=2026-10-05&dateTo=2026-10-05' \
--header 'Authorization: Bearer SEU_TOKEN'json
{
"data": [
{
"id": "cmu9r1a2b000101s6stmt0002",
"amount": -10250,
"balanceAfter": 150530,
"description": "Reserva de saque",
"endToEndId": "E99999999202610051440f6e5d4c3b2a",
"infractionProtocol": null,
"gross": 10000,
"fee": 250,
"status": "SETTLED",
"statusReason": null,
"statusAt": "2026-10-05T14:40:14.120Z",
"payoutOperation": "WITHDRAW",
"counterparty": {
"name": "Fulano de Tal",
"document": "***.456.789-**",
"bank": { "name": "Banco Exemplo S.A.", "ispb": "99999999" },
"pixKey": "f***@exemplo.com",
"account": null
},
"postedAt": "2026-10-05T14:40:11.002Z"
},
{
"id": "cmu9r1a2b000001s6stmt0001",
"amount": 1395,
"balanceAfter": 160780,
"description": "Pagamento recebido",
"endToEndId": "E99999999202610051433a1b2c3d4e5f",
"infractionProtocol": null,
"gross": 1500,
"fee": 105,
"status": null,
"statusReason": null,
"statusAt": null,
"payoutOperation": null,
"counterparty": {
"name": "Maria Souza",
"document": "52998224725",
"bank": { "name": "Banco Exemplo S.A.", "ispb": "99999999" },
"pixKey": null,
"account": null
},
"postedAt": "2026-10-05T14:33:10.004Z"
}
],
"nextCursor": "cmu9r1a2b000001s6stmt0001",
"balance": 150530
}Referência: Listar os lançamentos do extrato
Filtre e pagine
| Parâmetro | Regra |
|---|---|
cursor | O nextCursor da página anterior. A última página vem sem esse campo. |
dateFrom, dateTo | Data de criação. Data sem hora, ou meia-noite UTC exata, vale o dia inteiro no horário de Brasília. |
endToEndId | Acha as linhas de um Pix. Não acha transferências entre contas PayZu, que não passam pelo Pix. |
name | A partir de 2 caracteres. |
amount, document, status | Os outros filtros. |
Mantenha os mesmos filtros em todas as páginas e mude só o cursor. A paginação é só por cursor, e page é recusado com 400.
Leia cada linha
| Campo | Como ler |
|---|---|
amount | Positivo é entrada, e negativo, saída. |
description, status | Dizem o que é a linha, junto com o sinal de amount. |
counterparty | Com quem foi a operação. |
endToEndId | Nas linhas de cobrança, depósito e saque, o end-to-end do Pix de origem, inclusive em devolução e MED. |
infractionProtocol | O protocolo da infração, nas linhas de MED. |
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
REQUEST_UNKNOWN_QUERY_PARAM | 400 | A requisição tem um parâmetro de busca que esta rota não conhece. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.