PayZu PixConta e relatórios
Listar as transações
Liste as transações de um período para conciliar os pedidos, com o status e a contraparte de cada operação.
Liste as transações
bash
curl -G https://pix.sandbox.payzu.dev/v1/user/transactions \
-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" \
--data-urlencode "limit=10" \
--data-urlencode "page=1"json
{
"total": 104,
"pages": 11,
"transactions": [
{
"id": "PAYZU20260806M5KT9WB2LC000000",
"amount": 10,
"status": "PENDING",
"type": "DEPOSIT",
"qrCodeText": "00020126860014br.gov.bcb.pix...63048227",
"qrCodeBase64": null,
"qrCodeUrl": "https://pix.sandbox.payzu.dev/v1/pix/qr-code/PAYZU20260806M5KT9WB2LC000000",
"serviceFeeCharged": 0.075,
"payerDocument": null,
"payerName": null,
"payerInstitutionIspb": null,
"payerInstitutionName": null,
"receiverDocument": null,
"receiverName": null,
"receiverInstitutionIspb": null,
"receiverInstitutionName": null,
"generatedDocument": "00000000191",
"generatedName": "JOAO DA SILVA",
"generatedEmail": null,
"endToEndId": null,
"withdrawPixKey": null,
"withdrawPixType": null,
"paidAt": null,
"createdAt": "2026-08-06T22:06:19.598Z",
"updatedAt": "2026-08-06T22:06:19.598Z",
"clientReference": "order_12345",
"refundEndToEndId": null,
"refundAmount": null,
"refundStatus": null,
"refundReason": null,
"refundDescription": null,
"refundedAt": null,
"cancellationReason": null
},
{
"id": "PAYZU20260806M5KT9WB2LD000000",
"amount": 5.5,
"status": "ERROR",
"type": "WITHDRAW",
"qrCodeText": null,
"qrCodeBase64": null,
"qrCodeUrl": null,
"serviceFeeCharged": 1,
"payerDocument": null,
"payerName": null,
"payerInstitutionIspb": null,
"payerInstitutionName": null,
"receiverDocument": null,
"receiverName": null,
"receiverInstitutionIspb": null,
"receiverInstitutionName": null,
"generatedDocument": null,
"generatedName": null,
"generatedEmail": null,
"endToEndId": null,
"withdrawPixKey": "88888888888",
"withdrawPixType": "cpf",
"paidAt": null,
"createdAt": "2026-08-06T19:08:55.848Z",
"updatedAt": "2026-08-06T19:09:13.602Z",
"clientReference": null,
"refundEndToEndId": null,
"refundAmount": null,
"refundStatus": null,
"refundReason": null,
"refundDescription": null,
"refundedAt": null,
"cancellationReason": "Chave Pix não encontrada."
}
]
}Referência: Listar as transações
- Filtros: o período e
clientReference;status,typeemethodaceitam vários valores separados por vírgula. - Itens por página:
limitvai até 1.000, e a resposta traztotalepages. Veja Paginação. - Ordenação:
sortByaceitacreatedAtouupdatedAt. Ordene porupdatedAtpara ver primeiro as transações que mudaram de status.
Envie as datas com fuso.
Use o formato dos exemplos, com -03:00, para o dia bater com o seu. Ao paginar, mantenha o mesmo filtro e a mesma ordenação em todas as páginas.
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.