PayZu PixPagar com Pix

Ler um QR Code


Mostre a quem vai confirmar o pagamento o recebedor e o valor de um QR Code estático ou dinâmico.

Leia o QR Code

Envie o copia e cola em emv.

bash
curl -X POST https://pix.sandbox.payzu.dev/v1/pix/qrcode/read \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "emv": "00020101021226780014br.gov.bcb.pix2556api.payzu/pix/qr/v2/013318d6-2d7d-479e-8bb3-b5c7b9da688c5204000053039865802BR5905PAYZU6008SAOPAULO6217051320260118278956304FEFF"
  }'

Referência: Consultar os dados de um QR Code

CampoO que fazer
name, document, amountMostre para quem vai confirmar o pagamento.
qrCodeType, amountEditableGuarde: eles dizem se o usuário pode mudar o valor no pagamento.
expiresInSegundos até o QR Code dinâmico expirar.

O pagamento é outra chamada, descrita em Pagar um QR Code.

A leitura tem limite de consultas por conta.

Leia uma vez, guarde o resultado na sessão do pagamento e não repita a chamada a cada renderização de tela. Ao estourar o limite, a resposta é 429, com o tempo de espera em retryAfterSeconds.

Erros desta operação

CódigoHTTPMensagem
PZK401403Leitura de QR Code não habilitada para o usuário.
PZK310410Este QR Code expirou ou foi removido pela instituição financeira recebedora.
PZI110424Erro de comunicação com a instituição financeira.
PZK500424Consulta de QR Code temporariamente indisponível. Tente novamente.
PZG429429Limite de consultas atingido. Tente novamente em breve. Tente novamente em 30s.

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