QR Code PIX: Como Gerar para Seu Negocio
Guia especifico para empreendedores gerarem QR PIX estatico. Explica o padrao EMV/BRCODE, campos obrigatorios, como testar e diferencas entre PIX estatico e dinamico.
O PIX transformou a forma como os brasileiros fazem pagamentos, e o QR Code PIX e uma das funcionalidades mais usadas — especialmente por micro e pequenos empreendedores que precisam receber pagamentos sem maquininha de cartao. Neste guia, voce vai aprender tudo o que precisa para gerar, usar e confiar no QR PIX do seu negocio.
O que e o QR Code PIX?
O QR Code PIX e um codigo que codifica os dados do recebedor segundo o padrao EMV BRCODE (adaptado pelo Banco Central do Brasil do padrao EMV internacional). Quando o cliente escaneia o QR com o app do banco, todos os dados ja aparecem preenchidos — nome do recebedor, chave PIX e, se quiser, o valor.
O resultado e um pagamento instantaneo em segundos, sem cartao, sem maquininha, sem taxa por transacao.
PIX estatico vs PIX dinamico
Existem dois tipos de QR Code PIX, com propositos bem diferentes:
PIX estatico (gerado aqui):
- Os dados ficam codificados diretamente no QR
- Pode ser pago multiplas vezes por qualquer pessoa
- Ideal para cobranças recorrentes, balcao de loja, cardapio
- Gerado gratuitamente por qualquer pessoa, sem precisar de conta em banco especifico
- O valor pode ser livre (o pagador define) ou pre-definido
PIX dinamico:
- O QR aponta para uma URL na API do banco
- Cada QR e de uso unico (expirado apos o pagamento)
- Pode incluir dados de cobranca: vencimento, multa, desconto, juros
- Requer integração com API bancaria (mais tecnico, para e-commerces e sistemas ERP)
Para a maioria dos pequenos negocios — mercadinhos, restaurantes, profissionais liberais, artesaos, vendedores online — o PIX estatico e suficiente e muito mais simples de implementar.
Os campos do QR PIX estatico
Para gerar um QR PIX, voce precisa de:
Campos obrigatorios:
- Tipo de chave PIX: CPF, CNPJ, email, telefone ou chave aleatoria
- Chave PIX: O valor da chave no formato correto
- Nome do recebedor: Ate 25 caracteres, sem acentos
- Cidade do recebedor: Ate 15 caracteres, sem acentos
Campos opcionais:
- Valor (R$): Se deixado em branco, o pagador define o valor. Se preenchido, o app ja mostra o valor fixo.
- Descricao/identificador: Ate 25 caracteres. Aparece como descricao da transacao. Util para identificar o que esta sendo pago (“CAFEZINHO”, “CONSULTA 001”).
Validacao dos tipos de chave
Cada tipo de chave tem um formato especifico que deve ser seguido rigorosamente — caso contrario, os apps bancarios rejeitarao o pagamento:
- CPF: Exatamente 11 digitos numericos (sem pontos ou hifens):
12345678901 - CNPJ: Exatamente 14 digitos numericos (sem formatacao):
12345678000190 - Email: Deve conter
@e dominio valido:contato@meunegocio.com.br - Telefone: Formato internacional com +55 e DDD:
+5511999998888 - Chave aleatoria (EVP): UUID v4:
xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
Como funciona o padrao EMV BRCODE
O QR PIX e uma string de texto com uma estrutura especifica chamada TLV (Tag-Length-Value). Cada dado e identificado por um numero de dois digitos, seguido do tamanho e do conteudo.
Por exemplo, o campo da chave PIX fica dentro de um campo maior (ID 26) que tambem inclui o identificador do arranjo PIX (br.gov.bcb.pix). O payload termina com um CRC-16, que e uma “impressao digital” matematica que garante a integridade dos dados.
O nosso gerador implementa esse padrao rigorosamente, calculando o CRC-16/CCITT-FALSE corretamente. Todos os apps bancarios validam esse CRC — um QR com CRC errado e rejeitado imediatamente.
Testando seu QR PIX
Antes de usar em producao, faca esses testes:
- Escaneie com seu proprio celular — confirme que o app do banco exibe seu nome, cidade e valor corretos
- Teste com pelo menos 2 bancos diferentes — ex: Nubank e Itau, ou BB e Bradesco
- Verifique o nome e cidade — devem aparecer sem acentos (o padrao EMV nao suporta acentos nos campos Nome e Cidade)
- Teste o “Copia e Cola” — alem do QR, o payload de texto tambem funciona. Cole no campo “PIX Copia e Cola” do app do banco.
- Faca uma transacao real de R$ 0,01 — so assim voce tem certeza absoluta que o pagamento funciona
Onde usar o QR PIX
Ponto de venda (PDV): Imprima o QR em um suporte plastico ou moldura na frente do balcao. Coloque em tamanho minimo de 5cm × 5cm para leitura a ate 50cm.
Cardapio ou menu: Inclua o QR PIX junto com o cardapio para facilitar o pagamento apos a refeicao.
Rede social e WhatsApp: Salve o QR como imagem e envie no Instagram Stories, Status do WhatsApp ou em conversas com clientes.
Nota fiscal ou boleto: Inclua o QR PIX como imagem no PDF da nota ou recibo.
Site ou loja virtual: Exiba o QR na pagina de checkout como opcao de pagamento.
Seguranca e privacidade
Seus dados ficam no QR? Sim, o nome, cidade e chave PIX ficam codificados no QR. Qualquer pessoa que escanear o QR pode ver essas informacoes. Isso e normal e esperado — assim como um cartao de visita expoe seu telefone.
O pagamento pode ser estornado? O PIX tem mecanismo de devolucao (MED), mas apenas em casos de fraude comprovada e dentro do prazo definido pelo Banco Central. Para pagamentos normais, o PIX e irretornavel como transferencia bancaria.
O gerador envia minha chave para servidores? Nao. Todo o processamento — incluindo o calculo CRC-16 e a geracao do QR — acontece 100% no seu navegador. Sua chave nunca sai do seu dispositivo.
Conclusao
O QR Code PIX estatico e a solucao mais simples e eficiente para pequenos negocios aceitarem pagamentos instantaneos. Com os dados corretos e o padrao EMV implementado corretamente, voce tera um QR confiavel que funciona em todos os bancos, sem custo algum.