Gerador de QR Code Pix

Como funciona o QR Code Pix?

Por baixo está o BR Code, um padrão TLV (tag-length-value) herdado do EMV-CO, com campos para chave, beneficiário, valor, cidade e um CRC16 no fim.

Ele pode ser estático (sem valor, e quem paga digita a quantia) ou dinâmico (já com o valor fixo). Aqui geramos o estático/com valor.

A geração é toda no seu navegador. Se quiser, copie o BR Code e cole direto no app do banco.

PIX: o sistema de pagamentos instantâneos do Brasil (lançado nov/2020 pelo BC)

O PIX é o ecossistema de pagamentos instantâneos criado, operado e regulado pelo Banco Central do Brasil (BCB). Entrou em produção em 16 de novembro de 2020 e em menos de cinco anos se tornou o meio de pagamento mais usado no país, superando débito, crédito, boletos e transferências tradicionais somados. Movimenta dinheiro entre instituições participantes em segundos, 24/7/365 — sem janela de lote, sem horário comercial e sem atraso de liquidação.

O PIX roda sobre o SPI (Sistema de Pagamentos Instantâneos), infraestrutura de liquidação bruta em tempo real operada pelo BCB, e usa o DICT (Diretório de Identificadores de Contas Transacionais) para mapear chaves em contas bancárias. O canal de QR Code segue o padrão BR Code publicado pelo BCB, baseado na especificação internacional EMV QR Code for Payment Systems (EMVCo QRCPS).

QR Code Pix estático vs dinâmico: diferenças, limites, casos de uso

QR Code estático

O QR estático carrega a chave Pix e os dados do recebedor dentro do payload. O valor pode ser fixo ou aberto. São permanentes, podem ser pagos quantas vezes quiser e não dependem de backend. Casos de uso: vendedores ambulantes, comércios pequenos, freelancers, doações e gorjetas. A desvantagem é a conciliação: o lojista casa transações manualmente usando o txid (25 chars ASCII máx) ou cruzando nome do pagador, valor e horário.

QR Code dinâmico

O QR dinâmico embute uma URL que aponta para um JSON hospedado por um Provedor de Serviços de Pagamento (PSP). Quando o pagador escaneia, o app do banco busca essa URL, recupera valor, recebedor e txid e só então mostra a tela de confirmação. Cada QR dinâmico representa uma cobrança única com txid próprio (até 35 chars) e se torna inválido após o pagamento. São obrigatórios para comércio estruturado — checkout de e-commerce, assinaturas, marketplaces — e habilitam webhooks, conciliação instantânea, timers de expiração e a variante COBV com multa, juros e desconto.

Estrutura do BR Code (padrão EMVCo + adaptação BACEN): TLV, CRC16, campos obrigatórios

O payload PIX é uma string plana organizada como triplas TLV (Tag-Length-Value). Cada campo começa com um ID de dois dígitos, seguido do tamanho (dois dígitos) e do valor. Campos aninhados usam a mesma convenção recursivamente. Campos obrigatórios:

• 00 — Payload Format Indicator: sempre "01".
• 01 — Point of Initiation Method: "11" para estático (reutilizável) ou "12" para dinâmico (uso único); ausente significa reutilizável.
• 26 — Merchant Account Information: grupo aninhado com GUI BR.GOV.BCB.PIX e a chave Pix (ou URL, no dinâmico).
• 52 — Merchant Category Code: MCC ISO 18245, "0000" quando N/A.
• 53 — Transaction Currency: "986" (ISO 4217 Real).
• 54 — Transaction Amount: opcional no estático, obrigatório no dinâmico.
• 58 — Country Code: "BR".
• 59 — Merchant Name: até 25 chars ASCII, sem acentos.
• 60 — Merchant City: até 15 chars ASCII.
• 62 — Additional Data Field: grupo aninhado com txid (subcampo 05).
• 63 — CRC16: quatro chars hex maiúsculos, sempre o último.

O CRC16 usa CRC-16/CCITT-FALSE: polinômio 0x1021, inicial 0xFFFF, sem reflexão e sem XOR final. O input cobre tudo do byte zero até o prefixo literal "6304". Qualquer alteração — até um único espaço — produz um CRC diferente, permitindo detectar adulteração antes da tela de confirmação.

Chave Pix: CPF, CNPJ, e-mail, telefone, chave aleatória — qual usar

Uma chave Pix é um apelido dentro do DICT que aponta para uma conta bancária. Cinco tipos aceitos:

• CPF (11 dígitos) — expõe o documento do recebedor. Ruim para privacidade em QRs públicos.
• CNPJ (14 dígitos) — padrão para empresas; já é informação pública.
• E-mail — fácil de memorizar, profissional em domínio próprio.
• Telefone (+55DDDNNNNNNNNN) — conveniente, mas expõe o celular.
• Chave aleatória (UUID v4) — amiga da privacidade: nenhum dado pessoal é revelado.

Para QR Codes públicos (adesivos, sites, faturas), a chave aleatória é fortemente recomendada. Pessoa física pode registrar até 5 chaves; pessoa jurídica, até 20.

Cobrança com vencimento: PIX Cobrança v2, juros, multa, desconto

A Cobrança Pix com Vencimento (COBV) é a variante de QR dinâmico desenhada para substituir o boleto tradicional. Suporta data de vencimento, juros automáticos, multa automática, desconto por antecipação e abatimento. Após o vencimento, o app do pagador mostra o valor atualizado em tempo real. A COBV é criada via API Pix do BACEN com POST para /cobv contendo JSON com calendário, devedor, valor original e regras de cálculo. Regras suportam valores fixos e percentuais ao dia, ao mês ou ao ano. Quando a data de vencimento cai em fim de semana ou feriado, é prorrogada para o próximo dia útil.

Como gerar: ferramentas online, APIs (BACEN, Itaú, Mercado Pago), bibliotecas (qrcode.js)

Para QRs estáticos o payload pode ser montado localmente — sem chamada de rede. Bibliotecas open-source: qrcode (Node/browser, MIT), pixqrcode (Dart/Flutter), pix-payload (Java 21). Esta página usa essa abordagem: a string BR Code é montada em JavaScript, o CRC16 é anexado e renderizado com a biblioteca local qrcode.min.js — nenhum dado sai do navegador. Para QRs dinâmicos é preciso integrar com um PSP. A API Pix do BACEN é a mesma para todos os bancos, mas cada PSP a embrulha com sua própria autenticação (mTLS + OAuth2). Escolhas comuns: Mercado Pago, Asaas, Efí, OpenPix, Cora, Inter, Itaú, Banco do Brasil. A maioria expõe webhooks que disparam um POST para seu backend quando um pagamento é confirmado.

Segurança: golpe do QR Code, sempre confira o beneficiário

O PIX em si é altamente seguro — o SPI roda em rede fechada entre instituições reguladas e toda transferência é assinada e auditada. O elo fraco é a engenharia social. Golpes comuns: colar QR falso por cima do verdadeiro em parquímetros ou cardápios, mandar imagens de QR pelo WhatsApp se passando por contato conhecido e faturas falsas imitando empresas reais. Antes de confirmar, sempre confira três coisas no app do banco: nome completo do recebedor, banco e valor. Se não bater, cancele. Lojistas devem preferir chave aleatória a CPF/CNPJ em QRs públicos e monitorar webhooks do PSP em vez de prints enviados pelo cliente.

FAQ

O QR Code estático vence?

Não. É permanente e pode ser pago enquanto a chave Pix associada estiver ativa. A única forma de invalidá-lo é apagar a chave no app do banco.

Por que o nome só pode ter 25 caracteres?

O limite (campo 59) vem da especificação EMVCo QRCPS. Nomes maiores devem ser abreviados; acentos não são aceitos.

É seguro gerar QR Pix online?

Sim, desde que o payload seja montado localmente no navegador — que é o caso aqui. O QR codifica apenas informação pública; a transferência ainda exige que o pagador autorize dentro do próprio app do banco.

Posso colocar uma logo no meio do QR?

Tecnicamente sim — QR Codes têm correção de erros (nível H tolera até 30% de módulos danificados). Mantenha a logo pequena e centralizada para preservar a leitura em todos os apps de banco.

Diferença entre txid e EndToEndId?

O txid é definido pelo lojista antes do pagamento (25 chars no estático, 35 no dinâmico). O EndToEndId é atribuído pelo SPI na liquidação e é o identificador canônico — usado para confirmar recebimentos e pedir devoluções via MED do BACEN.