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"
}'json
{
"qrCodeType": "DYNAMIC",
"name": "LOJA EXEMPLO LTDA",
"document": "12345678000199",
"amount": 10,
"originalAmount": 10,
"txid": "c5886b83f0254d0dbfc3900f72d5a8d1",
"additionalInfo": null,
"expiresIn": 1799,
"createdAt": "2026-02-03T22:59:36.138"
}Referência: Consultar os dados de um QR Code
| Campo | O que fazer |
|---|---|
name, document, amount | Mostre para quem vai confirmar o pagamento. |
qrCodeType, amountEditable | Guarde: eles dizem se o usuário pode mudar o valor no pagamento. |
expiresIn | Segundos 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ódigo | HTTP | Mensagem |
|---|---|---|
PZK401 | 403 | Leitura de QR Code não habilitada para o usuário. |
PZK310 | 410 | Este QR Code expirou ou foi removido pela instituição financeira recebedora. |
PZI110 | 424 | Erro de comunicação com a instituição financeira. |
PZK500 | 424 | Consulta de QR Code temporariamente indisponível. Tente novamente. |
PZG429 | 429 | Limite 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.