PayZu PixReceber com Pix

Gerar a imagem do QR Code


Nesta páginaBaixe o PNGUse o base64 da cobrançaErros desta operação

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

Referê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

CódigoHTTPMensagem
PZK601400QR Code inválido ou mal formatado.
PZK301404QR Code não encontrado.

Os códigos de autenticação e de validação estão no Catálogo de erros.