PayZu PixConta e relatórios
Resumo do período
Veja numa chamada só quanto entrou, quanto saiu e quanto foi cobrado de tarifa no período, por tipo e por status.
Consulte o resumo
bash
curl -G https://pix.sandbox.payzu.dev/v1/user/summary \
-H "Authorization: Bearer SEU_TOKEN" \
--data-urlencode "dateFrom=2026-08-01T00:00:00-03:00" \
--data-urlencode "dateTo=2026-08-31T23:59:59-03:00"json
{
"totalTransactions": 42,
"deposit": {
"totalAmount": 1500,
"totalTransactions": 20,
"statuses": {
"pending": { "count": 1, "amount": 100, "serviceFeeCharged": 1.5 },
"completed": { "count": 18, "amount": 1350, "serviceFeeCharged": 20 },
"canceled": { "count": 0, "amount": 0, "serviceFeeCharged": 0 },
"expired": { "count": 1, "amount": 50, "serviceFeeCharged": 0 },
"refunded": { "count": 0, "amount": 0, "serviceFeeCharged": 0 }
}
},
"withdraw": {
"totalAmount": 800,
"totalTransactions": 12,
"statuses": {
"pending": { "count": 0, "amount": 0 },
"completed": { "count": 12, "amount": 800 },
"canceled": { "count": 0, "amount": 0 },
"expired": { "count": 0, "amount": 0 },
"refunded": { "count": 0, "amount": 0 }
}
},
"commission": {
"totalAmount": 30,
"totalTransactions": 10,
"statuses": {
"pending": { "count": 0, "amount": 0 },
"completed": { "count": 10, "amount": 30 },
"canceled": { "count": 0, "amount": 0 },
"expired": { "count": 0, "amount": 0 },
"refunded": { "count": 0, "amount": 0 }
}
}
}Referência: Consultar o resumo das transações
| Campo ou parâmetro | Como ler |
|---|---|
statuses.completed.amount | O que de fato entrou e saiu, em cada tipo. |
totalAmount | Soma todas as transações do tipo no período, inclusive status que não aparecem em statuses, como ERROR. Por isso pode passar da soma dos status listados. |
grouped=true | Acrescenta a série diária, que soma só as transações concluídas. |
Envie dateFrom e dateTo, com fuso.
Sem dateFrom, o período começa no início do dia anterior (America/Sao_Paulo); sem dateTo, termina no momento da consulta.
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.