PayZu PixConta e relatórios
Pedir um relatório
Peça o CSV das transações de um período, que a PayZu gera em segundo plano.
Peça o relatório
bash
curl -X POST https://pix.sandbox.payzu.dev/v1/user/report \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"dateFrom": "2026-05-01T00:00:00.000Z",
"dateTo": "2026-05-06T00:00:00.000Z"
}'json
{
"id": "5224fd4e-0abb-4498-a79b-9398ea6712ad",
"status": "PENDING",
"createdAt": "2026-05-06T16:39:52.944Z",
"updatedAt": "2026-05-06T16:39:52.944Z",
"params": {
"status": [],
"type": [],
"dateFrom": "2026-05-01T00:00:00.000Z",
"dateTo": "2026-05-06T00:00:00.000Z"
},
"writtenRows": null,
"storageExpiresAt": null
}Referência: Gerar um relatório de transações
| Campo | Regra |
|---|---|
dateFrom, dateTo | Obrigatórios. |
status, type | Listas com os status e os tipos de transação a incluir. Vazias ou omitidas, entram todos. |
A resposta vem com 202. Nela o prazo do arquivo se chama storageExpiresAt; nas consultas, expiresAt.
Um período sem nenhuma transação é recusado.
A resposta é 422, a mesma do terceiro pedido feito enquanto dois relatórios da conta estão em processamento.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZG422 | 422 | Nenhuma transação encontrada para o filtro aplicado. |
Os códigos de autenticação e de validação estão no Catálogo de erros.