QR Code PIX: como gerar, testar e imprimir sem erro (BR Code)

Você imprime um QR Code PIX na vitrine e o cliente aponta o celular — "PIX não encontrado" ou "QR Code inválido". Frustrante. Na maioria das vezes, o problema é no payload: falta o CRC16, campo obrigatório fora do padrão EMVCo, ou formato da chave PIX incorreto. Em 2026, o BR Code (padrão oficial do PIX) é a forma universal de gerar QR Code de pagamento — funciona em todos os bancos e carteiras. Neste guia do kitsapp. eu mostro a estrutura completa do payload BR Code (Merchant Account Information, Transaction Amount, Merchant Category Code, CRC16), como testar antes de imprimir, tamanhos mínimos por contexto, e como o Gerador de QR Code (com modo PIX) do kitapp gera tudo automaticamente, 100% no navegador, sem upload, com copia-cola automático.

1. O que é o QR Code PIX e como funciona o BR Code

O QR Code PIX é um QR Code que codifica um payload (texto estruturado) no padrão BR Code, definido pelo Banco Central no Manual de Padrões para Instalações do PIX. O BR Code é baseado no padrão internacional EMVCo QR Code (usado em cartões de débito/crédito no mundo todo), com adaptações para o contexto brasileiro.

Fluxo simplificado:

1. Você (recebedor) gera o QR Code PIX com chave (CPF/CNPJ/e-mail/celular/aleatória) e valor.
2. O cliente abre o app do banco (Nubank, Inter, Itaú, etc.) e aponta a câmera para o QR Code.
3. O app lê o payload, valida o CRC16, abre a tela de pagamento pré-preenchida com chave + valor.
4. O cliente confirma e o pagamento é processado em segundos (SPI do Banco Central).

Vantagens do QR Code PIX:

• Instantâneo: 2-5 segundos para confirmar (vs 1-3 dias do TED/DOC).
• 24/7: funciona em feriados, finais de semana, à noite.
• Sem taxa: pessoa física recebe sem custo; pessoa jurídica paga taxa pequena (0% a 1,5%).
• QR dinâmico ou estático: dinâmico = valor fixo por transação; estático = valor aberto, cliente digita.

Para o kitsapp., o caso de uso principal é o QR Code PIX estático (link de doação ou pagamento único), que pode ser gerado via Gerador de QR Code com chave + valor (opcional).

2. Estrutura do payload PIX: 4 campos obrigatórios e o CRC16

O payload BR Code segue o padrão EMVCo TLV (Tag-Length-Value): cada campo tem um ID (Tag), um tamanho (Length), e um valor (Value). O texto final é uma concatenação de TLVs.

Estrutura completa (versão simplificada):

Exemplo de payload PIX válido (chave CPF 123.456.789-00, valor R$ 10,00, nome João Silva, cidade São Paulo):

Esse é o texto que vai virar QR Code. Quando o cliente escaneia, o app do banco lê esse texto, valida o CRC16 (últimos 4 chars hex), extrai chave e valor, e abre a tela de pagamento.

Detalhe importante — CRC16: o campo 63 (CRC16) é o "código de verificação" do payload — calculado sobre todos os outros campos. Se você montar o payload errado (esquecer um campo, colocar vírgula em vez de ponto, ou errar a ordem), o CRC16 não bate e o app rejeita. É por isso que gerar manualmente dá errado: use sempre uma biblioteca ou gerador validado.

3. Como gerar QR Code PIX: passo a passo com exemplo

Para gerar o QR Code PIX do zero, você precisa montar o payload e calcular o CRC16. Em código (JavaScript, para o navegador):

Esse é o algoritmo básico. Para o kitsapp., o Gerador de QR Code (com modo PIX) faz isso em 1 clique: você preenche chave, valor, nome, cidade, e ele monta o payload, calcula o CRC16 e gera o QR Code. Tudo no navegador.

4. Como testar o QR Code PIX antes de imprimir (3 verificações)

Antes de imprimir 1.000 folhetos com QR Code PIX, teste — 3 verificações essenciais:

1. Validação do payload (copia-cola): gere o QR Code e copie o payload (string de texto). Cole no app do banco — se abrir a tela de pagamento com chave e valor corretos, o payload está válido.
2. Validação do QR Code (escaneando): gere o QR Code e escaneie com 3 apps diferentes (Nubank, Inter, Itaú). Se todos abrem a mesma tela com os mesmos dados, o QR Code está OK.
3. Validação visual (tamanho e contraste): imprima um protótipo e escaneie em condições reais (luz solar, ângulo de 45°). Se funcionar, está OK para produção.

Teste automatizado: existe uma ferramenta do Banco Central chamada BR Code Validator (pública, no GitHub do BCB) que valida o payload quanto à conformidade com o padrão. Use para auditar antes de imprimir em grande escala.

5. Tamanho mínimo e correção de erro para impressão

Para QR Code impresso, há 2 variáveis importantes: tamanho físico mínimo e nível de correção de erro.

Regra prática para tamanho: o QR Code deve ter 10x o tamanho do menor módulo (pixel) para leitura confortável. Se o menor pixel é 1mm, o QR Code tem 10mm = 1cm mínimo. Para impressão, prefira 200-300 dpi (resolução de impressora comum) e margem de "quiet zone" (4 módulos brancos ao redor).

6. Use o gerador de QR Code PIX do kitsapp. (com copia e cola)

O Gerador de QR Code do kitsapp. (com modo PIX) resolve em 1 clique:

1. Selecione o modo "PIX" (em vez de URL/texto/Wi-Fi/vCard).
2. Preencha: chave PIX (CPF, CNPJ, e-mail, celular ou aleatória), valor (opcional), nome do recebedor (até 25 chars), cidade (até 15 chars), txid (opcional).
3. Escolha o tamanho (200-1000 px) e o nível de correção (L/M/Q/H).
4. Clique "Gerar".
5. Veja o QR Code na tela + payload em texto (para copia-cola).
6. Baixe como PNG ou SVG, ou copie o payload.

Recursos extras:

• Payload em texto: ao lado do QR Code, mostra o payload BR Code (formato copia-cola) — útil para quem prefere colar no app em vez de escanear.
• Validação CRC16: calcula e exibe o CRC16 usado. Para auditoria, você pode conferir o resultado.
• SVG/PNG download: SVG para impressão vetorial (sem perda); PNG para web e PDF.
• 100% client-side: nada sai do seu navegador. Chave PIX, valor, nome — tudo processado localmente. LGPD-conformidade total.

Em resumo, gerar QR Code PIX em 2026 exige seguir o padrão BR Code do Banco Central, com payload correto, CRC16 válido, e teste antes de imprimir. O Gerador de QR Code (modo PIX) do kitsapp. faz tudo em 1 clique, com validação CRC16, copia-cola do payload, e download em SVG/PNG. Para o usuário final, é a tranquilidade de imprimir 1.000 folhetos sabendo que o QR Code vai funcionar. Para quem tem loja física, é a ferramenta essencial — use o tamanho 10×10 cm para vitrine, 3×3 cm para folheto, 2×2 cm para cartão. Para nivel de correção, prefira Q (25%) ou H (30%) para ambientes de uso intenso (chaveiro, mochila).

Conclusão: o QR Code PIX é o padrão de pagamento instantâneo no Brasil, baseado no EMVCo BR Code. Para gerar corretamente, é preciso montar o payload TLV com 4 campos obrigatórios (Merchant Account, MCC, Transaction Amount, CRC16) e calcular o CRC16 (CCITT). O Gerador de QR Code (modo PIX) do kitsapp. faz isso em 1 clique, com validação, copia-cola e download — 100% no navegador, com privacidade LGPD. Antes de imprimir, teste em 3 apps de banco diferentes. Para tamanhos, prefira 10×10 cm em cartazes, 3×3 cm em folhetos, 2×2 cm em cartões, com nível de correção Q (25%).