PayZu PixReceber com Pix
Gerar a imagem do QR Code
Baixe o QR Code de uma cobrança já criada como arquivo PNG, pronto para imprimir ou anexar, sem converter base64.
Baixe o PNG
bash
curl https://pix.sandbox.payzu.dev/v1/pix/qr-code/PAYZU20260814T6NX1CV9MK000000 \
-H "Authorization: Bearer SEU_TOKEN" \
--output qr-code.pngbash
# HTTP/1.1 200 OK
# Content-Type: image/png
# O corpo é o PNG do QR Code; com --output, o curl grava em qr-code.pngReferência: Gerar a imagem do QR Code de uma cobrança
A rota exige o token.
O qrCodeUrl serve para a sua aplicação baixar a imagem, não para uma tag img pública.
Use o base64 da cobrança
Se você já tem a resposta de POST /pix ou de GET /pix, não precisa de outra chamada: qrCodeBase64 traz o mesmo PNG em base64, sem prefixo.
js
import { writeFile } from 'node:fs/promises'
const src = `data:image/png;base64,${charge.qrCodeBase64}`
// <img alt="QR Code Pix" src={src}>
const png = Buffer.from(charge.qrCodeBase64, 'base64')
await writeFile('qr-code.png', png)O QR Code de uma cobrança expirada ou já paga continua sendo gerado.
Ele não aceita novo pagamento, então confira o status antes de mostrar.
Erros desta operação
Os códigos de autenticação e de validação estão no Catálogo de erros.