PayZu PixTutoriais
Conciliar as transações do dia
Use datas com fuso. Aqui o dia vai de 00:00 a 23:59:59 no horário de Brasília.
GET /user/summary totaliza as entradas e as saídas do período por status, com quantidade e valor.
Peça até 1000 por página e siga até pages. Cruze clientReference e endToEndId com o seu banco para achar o que falta.
POST /user/report enfileira o relatório do período. Sem transação no filtro, a resposta é 422.
O status passa por PENDING e RUNNING até chegar a COMPLETED ou FAILED.
POST .../download retorna um link temporário: baixe antes de expiresAt. Relatório expirado responde 410.
reconcile-the-day.js
import { writeFile } from 'node:fs/promises' const API = 'https://pix.sandbox.payzu.dev/v1'const auth = { authorization: `Bearer ${process.env.PAYZU_TOKEN}` }const get = (path) => fetch(`${API}${path}`, { headers: auth }).then((r) => r.json())const day = { dateFrom: '2026-08-10T00:00:00-03:00', dateTo: '2026-08-10T23:59:59-03:00' } const summary = await get(`/user/summary?${new URLSearchParams(day)}`)console.log(summary.deposit.statuses.completed, summary.withdraw.statuses.completed) const transactions = []for (let page = 1; ; page++) { const list = await get(`/user/transactions?${new URLSearchParams({ ...day, limit: 1000, page })}`) transactions.push(...list.transactions) if (page >= list.pages) break}for (const t of transactions) console.log(t.clientReference, t.endToEndId, t.status, t.amount, t.serviceFeeCharged) const job = await fetch(`${API}/user/report`, { method: 'POST', headers: { ...auth, 'content-type': 'application/json' }, body: JSON.stringify(day)}).then((r) => r.json())if (!job.id) throw new Error(`${job.errorCode}: ${job.message}`) let report = jobwhile (report.status === 'PENDING' || report.status === 'RUNNING') { await new Promise((resolve) => setTimeout(resolve, 3000)) report = await get(`/user/report/${job.id}`)}if (report.status !== 'COMPLETED') throw new Error(`Relatório ${report.status}`) const { url } = await fetch(`${API}/user/report/${job.id}/download`, { method: 'POST', headers: auth }).then((r) => r.json())const csv = await fetch(url).then((r) => r.arrayBuffer())await writeFile('transacoes-2026-08-10.csv', Buffer.from(csv))
Resposta · 200 Lista de transações
{ "total": 104, "pages": 2, "transactions": [ { "id": "PAYZU20261106M5KT9WB2LC000000", "amount": 10, "status": "PENDING", "type": "DEPOSIT", "qrCodeText": "00020126820014br.gov.bcb.pix2560qrcode.payzu.com.br/pix/66666666-7777-8888-9999-0000000000005204000053039865802BR5908PAYZPLUS6009SAO PAULO62070503***6304204E", "qrCodeBase64": null, "qrCodeUrl": "https://pix.payzu.com.br/v1/pix/qr-code/PAYZU20261106M5KT9WB2LC000000", "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": "2025-11-06T22:06:19.598Z", "updatedAt": "2025-11-06T22:06:19.598Z", "clientReference": "order_12345", "refundEndToEndId": null, "refundAmount": null, "refundStatus": null, "refundReason": null, "refundDescription": null, "refundedAt": null, "cancellationReason": null }, { "id": "PAYZU20261106M5KT9WB2LD000000", "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": "2025-11-06T19:08:55.848Z", "updatedAt": "2025-11-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