PayZu PixTutoriais
Receber um pagamento com Pix
Todas as chamadas levam o seu token Bearer.
POST /pix com o valor em reais, o seu clientReference, que evita cobrança duplicada, e a callbackUrl que recebe o aviso.
Entregue o qrCodeText, o copia e cola, ou desenhe o QR Code a partir dele.
Com o segredo de callback criado, o aviso chega assinado no X-Callback-Signature. Confira o horário e a assinatura em tempo constante e dê baixa quando o status for COMPLETED.
receive-pix-payment.js
import crypto from 'node:crypto'import express from 'express' const API = 'https://pix.sandbox.payzu.dev/v1'const headers = { authorization: `Bearer ${process.env.PAYZU_TOKEN}`, 'content-type': 'application/json'} const response = await fetch(`${API}/pix`, { method: 'POST', headers, body: JSON.stringify({ amount: 49.9, clientReference: 'pedido-1234', callbackUrl: 'https://sualoja.com.br/webhooks/payzu' })})const charge = await response.json() // mostre o copia e cola para o clienteconsole.log(charge.qrCodeText) const app = express()app.post('/webhooks/payzu', express.raw({ type: '*/*' }), (req, res) => { const parts = Object.fromEntries(String(req.get('X-Callback-Signature')).split(',').map((p) => p.trim().split('='))) const t = Number(parts.t) if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > 300) return res.sendStatus(401) const expected = crypto.createHmac('sha256', process.env.PAYZU_CALLBACK_SECRET).update(`${t}.${req.body}`).digest() const received = Buffer.from(parts.v1 ?? '', 'hex') if (received.length !== expected.length || !crypto.timingSafeEqual(received, expected)) return res.sendStatus(401) const event = JSON.parse(req.body) if (event.status === 'COMPLETED') markOrderPaid(event.clientReference) res.sendStatus(200)})app.listen(3000)
Resposta · 200 Cobrança criada
{ "id": "PAYZU20260811R4TZ8WD1NC000000", "status": "PENDING", "amount": 10, "type": "DEPOSIT", "qrCodeText": "00020126860014br.gov.bcb.pix2564qrcode.payzu.com.br/dynamic/11111111-2222-3333-4444-5555555555555204000053039865802BR5909PAYZUPLUS6009SAO PAULO62070503***630489B0", "qrCodeBase64": "iVBORw0KGgoAAAANSUhEUgAAAZAAAAGQCAYAAAC...", "qrCodeUrl": "https://pix.payzu.com.br/v1/pix/qr-code/PAYZU20260811R4TZ8WD1NC000000", "generatedName": "John Doe", "generatedDocument": "12345678901", "generatedEmail": "john.doe@example.com", "serviceFeeCharged": 0.075, "payerName": null, "payerDocument": null, "payerInstitutionIspb": null, "payerInstitutionName": null, "payerAccountNumber": null, "receiverName": null, "receiverDocument": null, "receiverInstitutionIspb": null, "receiverInstitutionName": null, "receiverAccountNumber": "000000", "endToEndId": null, "createdAt": "2026-08-11T21:59:11.579Z", "updatedAt": "2026-08-11T21:59:11.579Z", "paidAt": null, "withdrawPixKey": null, "withdrawPixType": null, "clientReference": "order_12345", "refundEndToEndId": null, "refundAmount": null, "refundStatus": null, "refundReason": null, "refundDescription": null, "refundedAt": null, "cancellationReason": null}
Referência: Criar uma cobrança Pix com QR Code