O que é um validador de chave Pix?
Um validador de chave Pix é uma ferramenta que verifica se um texto tem o formato de uma chave Pix legítima e identifica o tipo: CPF, CNPJ, e-mail, telefone celular ou chave aleatória (EVP). Para CPF e CNPJ ele recalcula os dígitos verificadores, o que elimina a maioria dos erros de digitação; para telefone e e-mail ele devolve a forma normalizada que é gravada no campo 26-01 do BR Code. Ele não consulta o Banco Central nem nenhum banco: uma chave com formato válido pode não estar cadastrada, e isso só o app do pagador descobre na hora de pagar.
Os cinco tipos de chave Pix
| Tipo de chave | Formato no código (campo 26-01) | Exemplo |
|---|---|---|
| CPF | 11 dígitos, sem pontos nem traço | 12345678909 |
| CNPJ | 14 dígitos, sem pontuação | 11222333000181 |
| Como cadastrado, até 77 caracteres | loja@exemplo.com.br | |
| Telefone celular | +55, DDD e número (formato E.164) | +5511912345678 |
| Chave aleatória (EVP) | UUID de 36 caracteres gerado pelo banco | 123e4567-e12b-12d1-a456-426655440000 |
Como o validador decide o tipo
- Chave aleatória: 32 dígitos hexadecimais separados por hífens no formato 8-4-4-4-12. É sempre reconhecida primeiro.
- E-mail: contém um
@e um ponto no domínio, até 77 caracteres. - CPF e CNPJ pontuados:
000.000.000-00e00.000.000/0000-00são tratados pelo tipo e têm os dígitos verificadores conferidos. - Telefone: começa com +55 ou 55 e tem 12 ou 13 dígitos, ou tem 11 dígitos com DDD e o 9 do celular.
- Só dígitos: 11 dígitos com verificador válido são CPF; 14 dígitos com verificador válido são CNPJ; caso contrário o validador informa qual verificação falhou.
Exemplo prático: dígitos verificadores do CPF
Tome o CPF de exemplo 529.982.247-25. Os nove primeiros dígitos são multiplicados por 10, 9, 8 … 2 e somados: 5×10 + 2×9 + 9×8 + 9×7 + 8×6 + 2×5 + 2×4 + 4×3 + 7×2 = 295. O resto de 295 × 10 dividido por 11 é 2, o primeiro dígito verificador. Repetindo com dez dígitos e pesos de 11 a 2, o resultado é 5, o segundo dígito. Como 25 confere, o validador aceita a chave e mostra a forma normalizada 52998224725, que é como ela vai no código. Troque o final para 26 e o resultado passa a "CPF inválido". O CNPJ segue a mesma ideia com pesos 5,4,3,2,9,8,7,6,5,4,3,2 e depois 6,5,4,3,2,9,8,7,6,5,4,3,2.
Erros comuns que o validador pega
| Entrada | Resultado | Por quê |
|---|---|---|
529.982.247-26 | CPF inválido | Dígitos verificadores não conferem (um número trocado) |
11 1234-5678 | Não reconhecido | Telefone fixo com 8 dígitos; chave Pix usa celular com 9 |
nome@email | Não reconhecido | Falta o domínio com ponto |
11.222.333/0001-81 | CNPJ válido → 11222333000181 | Pontuação removida para o código |
Fulano@Example.com | E-mail → fulano@example.com | Normalizado para minúsculas |
O que fazer depois de validar
Se a chave é sua, gere o código no gerador de QR Code Pix; o gerador usa a mesma detecção e mostra o tipo em tempo real enquanto você digita. Se a chave é de outra pessoa, inicie um Pix no seu app com essa chave e confira o nome exibido na tela de confirmação antes de concluir; essa é a única verificação de cadastro que existe. Para inspecionar um código inteiro em vez de só a chave, use o decodificador Pix.
Referências
Tipos e formatos de chave: Banco Central do Brasil, Pix e Manual de Padrões para Iniciação do Pix; dígitos verificadores de CPF e CNPJ conforme os algoritmos públicos da Receita Federal (módulo 11); telefone conforme ITU-T E.164; chave aleatória conforme RFC 4122 (UUID).