PayZu PixTutoriais

Conciliar as transações do dia

  1. Use datas com fuso. Aqui o dia vai de 00:00 a 23:59:59 no horário de Brasília.

  2. GET /user/summary totaliza as entradas e as saídas do período por status, com quantidade e valor.

  3. Peça até 1000 por página e siga até pages. Cruze clientReference e endToEndId com o seu banco para achar o que falta.

  4. POST /user/report enfileira o relatório do período. Sem transação no filtro, a resposta é 422.

  5. O status passa por PENDING e RUNNING até chegar a COMPLETED ou FAILED.

  6. 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