PayZu PixTutoriais

Receber um pagamento com Pix

  1. Todas as chamadas levam o seu token Bearer.

  2. POST /pix com o valor em reais, o seu clientReference, que evita cobrança duplicada, e a callbackUrl que recebe o aviso.

  3. Entregue o qrCodeText, o copia e cola, ou desenhe o QR Code a partir dele.

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