PayZu PixConta e relatórios
Listar o extrato
Feche o caixa pelos lançamentos do extrato, que mostram cada movimento no saldo.
Liste os lançamentos do extrato
createdAtFrom e createdAtTo são obrigatórios.
bash
curl -G https://pix.sandbox.payzu.dev/v1/user/bank-statements \
-H "Authorization: Bearer SEU_TOKEN" \
--data-urlencode "createdAtFrom=2026-08-01T00:00:00-03:00" \
--data-urlencode "createdAtTo=2026-08-31T23:59:59-03:00" \
--data-urlencode "limit=10"json
{
"pagination": {
"page": 1,
"limit": 10,
"hasNextPage": true
},
"bankStatements": [
{
"id": "bs_1",
"amount": 100,
"operation": "INCREMENT",
"reason": "Depósito Pix",
"balanceType": "AVAILABLE",
"previousBalanceAvailable": 400,
"previousBalanceBlocked": 0,
"newBalanceAvailable": 500,
"newBalanceBlocked": 0,
"transactionId": "PAYZU2025...",
"infractionId": null,
"createdAt": "2026-08-10T12:00:00.000Z",
"updatedAt": "2026-08-10T12:00:00.000Z"
}
]
}Referência: Listar os lançamentos do extrato
| Campo | O que traz |
|---|---|
operation | INCREMENT no crédito e DECREMENT no débito. |
balanceType | Qual saldo moveu: AVAILABLE ou BLOCKED. |
previousBalanceAvailable, previousBalanceBlocked, newBalanceAvailable, newBalanceBlocked | O saldo antes e depois do lançamento. |
transactionId, infractionId | A transação ou a infração que originou o lançamento. |
limit vai até 100, e a paginação informa hasNextPage em vez de total.
Os códigos de erro desta rota são os de autenticação e de validação, que estão no Catálogo de erros.