PIX
Gera um BR Code estático no padrão EMV do Banco Central. Funciona em qualquer banco ou carteira que leia PIX.
Campos
| Campo | Obrigatório | Limite |
|---|---|---|
| Chave PIX | sim | — |
| Nome do beneficiário | sim | 25 caracteres |
| Cidade | sim | 15 caracteres |
| Valor | não | — |
| Identificador (txid) | não | 25 caracteres |
| Mensagem | não | até 72, conforme sobra |
Tipos de chave aceitos
O produto identifica o tipo sozinho — você só cola a chave.
| Tipo | Formato | Observação |
|---|---|---|
| CPF | 11 dígitos | Dígito verificador conferido |
| CNPJ | 14 dígitos | Dígito verificador conferido |
nome@dominio.com | — | |
| Telefone | 10 ou 11 dígitos, com ou sem 55 | Normalizado para +55… |
| Aleatória (EVP) | UUID de 36 caracteres | — |
Pontuação é removida sozinha: 123.456.789-09 e 12345678909 dão no mesmo.
CPF e CNPJ passam por validação de dígito verificador. Se você digitou um número que não fecha, o QR não é gerado — e isso é proposital: um PIX com chave errada só descobre o erro na hora em que alguém tenta pagar.
Nome e cidade
Os dois passam por uma limpeza obrigatória do padrão EMV:
- acentos são removidos —
São PauloviraSAO PAULO; - caracteres fora do ASCII imprimível viram espaço;
- espaços repetidos são colapsados;
- o texto é cortado no limite (25 para o nome, 15 para a cidade);
- a cidade é convertida para maiúsculas.
Isso não é escolha do produto: o padrão do BR Code exige. Se o seu nome fantasia tem mais de 25 caracteres, escolha a abreviação você mesmo em vez de deixar o corte decidir.
Valor
Deixar o valor em branco produz um QR de valor livre: quem paga digita quanto quer. É o certo para gorjeta, doação e “me paga aí”.
Preencher o valor trava a quantia. Aceita vírgula ou ponto (10,50 e
10.50 são a mesma coisa) e é sempre gravado com duas casas.
Um QR PIX com valor é estático: o valor está gravado nos módulos. Para cobrar outro valor, gere outro QR. Não existe “editar o valor depois” em PIX estático.
Identificador (txid)
Serve para você reconciliar o pagamento no extrato. Aceita apenas letras,
números e *; o resto é removido. Em branco, vira ***, que é o valor padrão
para “sem identificador”.
Para cobranças diferentes que você precisa distinguir, use um txid por cobrança.
Mensagem
Aparece para quem paga, em alguns aplicativos. O espaço dela é o que sobra no campo do padrão depois da chave — chaves longas (e-mail comprido, EVP) deixam pouco ou nenhum espaço. Se a sua mensagem sumir, é isso.
O CRC
O payload termina com um CRC16-CCITT calculado sobre todo o conteúdo. É o que faz o app do banco aceitar o código. O produto calcula e valida sozinho — não há nada a fazer aqui, mas é a razão de você não conseguir editar o texto do payload na mão.
Antes de imprimir
- Escaneie com o app do seu próprio banco e confira nome, cidade e valor na tela de confirmação, antes de pagar.
- Faça um pagamento real de R$ 0,01 para você mesmo, se for material de grande tiragem. Um centavo é barato perto de reimprimir mil folhetos.
- Confira se o nome que aparece é reconhecível para quem vai pagar — é ele que dá (ou tira) a confiança na hora.
QR de pagamento é alvo preferido de fraude por adesivo colado por cima. Se o seu QR fica exposto ao público, confira periodicamente se ninguém colou outro em cima do seu. Veja Segurança e privacidade.