Gerador de QR Code Pix

Campos do BR Code e o checksum CRC16

O Pix Copia e Cola é uma sequência de campos no formato TLV (Tag, Length, Value): um identificador de 2 dígitos, o tamanho do valor em 2 dígitos e o valor. O campo 00 indica a versão do formato, o 01 diz se o código é estático (11) ou dinâmico (12), o 26 carrega a conta do recebedor (o identificador br.gov.bcb.pix, a chave Pix e uma descrição opcional em subcampos), o 52 traz a categoria do comerciante, o 53 a moeda (986, real) e o 54 o valor, quando há. Os campos 58, 59 e 60 trazem país (BR), nome (até 25 caracteres) e cidade (até 15), e o 62 leva o identificador da transação.

O último campo, o 63, é o CRC16 (variante CCITT-FALSE: polinômio 0x1021, valor inicial 0xFFFF), calculado sobre todo o texto até ele, incluindo os caracteres 6304 que abrem o próprio campo. Trocar um único caractere muda o CRC, e é assim que os apps de banco recusam um código corrompido ou adulterado. Como os tamanhos usam 2 dígitos, nenhum campo passa de 99 caracteres, inclusive o 26, que reúne identificador, chave e descrição.

• Campo 01: 11 para código estático, 12 para dinâmico.
• Campo 26: br.gov.bcb.pix, chave e descrição opcional, no máximo 99 caracteres somados.
• Campo 54: valor com ponto e duas casas. Sem esse campo, o pagador digita o valor.
• Campo 62: identificador (txid) com até 25 letras e números, ou *** quando não há.
• Campo 63: CRC16 de todo o restante do código.

CPF, CNPJ, e-mail, telefone e chave aleatória

Cada tipo de chave entra no código de um jeito. CPF entra com 11 dígitos e CNPJ com 14 caracteres, sem pontuação, e os dígitos verificadores são conferidos antes de gerar (o CNPJ pode ser alfanumérico no novo formato). O e-mail entra em minúsculas. O telefone entra no formato internacional, com o prefixo +55, o DDD e o número, sem espaços, parênteses ou traços: a ferramenta acrescenta o +55 sozinha. A chave aleatória (EVP) é um UUID de 32 caracteres hexadecimais com hífens, e a ferramenta também aceita colada sem hífens e reescreve no formato certo.

Onze dígitos soltos podem ser um CPF ou um telefone digitado sem o +55. Como a chave de telefone exige o +55, a ferramenta lê números soltos como CPF e, se o CPF for inválido e os números parecerem um celular, sugere usar como telefone. Ela valida só o formato: nunca consegue saber se a chave está cadastrada, ativa ou é sua, o que só existe dentro do sistema do Banco Central e das instituições.

Do QR Code na tela ao balcão da loja

Para o balcão, o botão de cartaz abre a impressão de uma folha A6 ou A5 com o texto Pague com Pix, o QR Code grande, o nome do recebedor, o valor (ou a indicação de que quem paga escolhe) e a cidade. Para quem cobra várias pessoas, a aba de lote lê uma lista de linhas no formato rótulo;valor;txid, gera um QR Code por linha com a sua chave e entrega um ZIP com os PNGs (e SVGs, se quiser) mais uma planilha CSV com os códigos Copia e Cola.

A aba Ler Copia e Cola faz o caminho inverso, do lado de quem paga: mostra chave, nome, cidade, valor e identificador de um código recebido, confere o CRC e aponta o que está fora do padrão. É a forma mais rápida de testar um código gerado aqui ou desconfiar de um código que chegou por mensagem.

O que esta ferramenta faz e o que ela não faz

A ferramenta roda inteira no navegador. Chave, nome, cidade e valor não são enviados a servidor, e nada fica salvo, a menos que você ligue a opção de lembrar, que guarda só chave, nome e cidade neste navegador. Lembre que o QR Code é um texto aberto: quem o escaneia ou cola o Copia e Cola lê a chave inteira. Por isso, em cartaz, cardápio ou site, vale usar chave aleatória em vez de CPF, telefone ou e-mail.

Gerar um QR Code não cria a chave nem a registra: ela precisa já existir e estar ativa no seu banco, senão o pagamento falha. O código gerado é estático e não identifica quem pagou. Se você precisa de cobrança com valor, vencimento e conciliação automática, o caminho é o Pix dinâmico, gerado pelo provedor de pagamento.