CASO DE USO
Valide o formato do identificador antes do seu provedor de KYC processar a chamada
Provedores de KYC cobram por tentativa — Idwall, Unico, Truora e Veriff faturam no envio, nao no resultado. Um usuario que informa um CPF com digito verificador invalido ou um CNPJ com comprimento incorreto desperdicra essa tentativa. O Normadata e o gate de formato que roda antes da chamada de KYC para que voce envie apenas dados estruturalmente validos. O Normadata e pre-KYC, nao e KYC.
O Normadata nao e KYC. E o gate de formato anterior ao KYC. O Normadata valida que um ID fiscal ou numero de documento e estruturalmente valido — nao verifica identidade, nao consulta listas de sancoes nem realiza nenhuma triagem AML ou antifraude. Use o Normadata antes de enviar dados ao seu provedor de KYC (Sumsub, Onfido, Truora, Mati). Nunca como substituto.
O PROBLEMA
Inputs com formato invalido queimam orcamento de KYC
Provedores de KYC no Brasil cobram tipicamente entre R$1,50 e R$15,00 por verificacao, dependendo do provedor e do tipo de cheque. Envios com CPF ou CNPJ invalidos falham imediatamente — e ainda sao cobrados.
Provedores de KYC faturam no envio
Um usuario informa um CPF com 11 digitos mas cujo segundo digito verificador esta errado. O provedor recebe a requisicao, determina que o documento esta malformado, retorna um erro — e cobra pela tentativa. O custo por envio frustrado e o mesmo de um bem-sucedido.
Regras de formato especificas por pais sao nao-triviais
O CPF (Brasil) tem dois digitos verificadores sequenciais calculados por modulo 11 com pesos especificos. O CNPJ (Brasil) tem 14 digitos com dois digitos verificadores com conjuntos de pesos distintos. Sem essas regras implementadas corretamente, voce nao consegue detectar inputs malformados no lado do cliente.
Regex no frontend nao e suficiente
Um padrao comum e adicionar uma verificacao basica de comprimento no frontend. Isso detecta erros obvios mas nao pega erros de checksum — um CPF com 11 digitos que falha nos dois calculos de digito verificador e invalido e sera rejeitado por qualquer provedor serio.
POR QUE AS SOLUCOES PADRAO NAO SAO SUFICIENTES
Por que as abordagens comuns deixam a lacuna
Regex no cliente
Detecta comprimento e tipo de caractere, nao validade de checksum. Uma string de 11 digitos que falha o calculo do CPF ainda passa a regex. O erro aparece no provedor de KYC, nao no formulario.
Biblioteca de validacao interna
Construir e manter implementacoes corretas de checksum para CPF, CNPJ e outros identificadores LATAM e um investimento significativo de engenharia. Casos limite de algoritmo (CPF com sequencia repetida como 111.111.111-11 sao tecnicamente invalidos) sao mal documentados e faceis de errar.
Depender das mensagens de erro do provedor de KYC
Provedores de KYC retornam codigos de erro opacos para inputs malformados. Voce precisa parsear formatos de erro especificos por provedor, mapeá-los para mensagens ao usuario e absorver o custo da chamada frustrada.
COMO O NORMADATA AJUDA
Como o Normadata ajuda
Chame o Normadata validate antes de chamar seu provedor de KYC. Se valid=false, aborte e mostre ao usuario uma mensagem de erro especifica ao formato. Custo zero ao orcamento de KYC, feedback imediato ao usuario. O Normadata retorna a forma normalizada do identificador mais o tipo de contribuinte (pessoa fisica / pessoa juridica / generico). Use isso para pre-popular campos estruturados no payload de envio do seu KYC. Um endpoint trata CPF, CNPJ, CUIT, RUT, NIT e mais. Mesmo schema JSON para todos os paises — voce escreve a logica de gate uma vez. VEJA EM ACAO
Veja em acao
# Pre-KYC gate: validate a batch of CPFs before sending to your KYC vendor
$ curl -X POST api.normadata.io/v1/validate/tax-ids \
-H "X-API-Key: nd_a8f3b2c1d4e5f6g7h8i9j0k1l2m3n4o5" \
-d '{"items":[
{"id":"ok","country":"BR","type":"cpf","value":"111.444.777-35"},
{"id":"bad","country":"BR","type":"cpf","value":"111.444.777"}
]}'
{
"results": [
{
"id": "ok",
"country": "BR",
"type": "cpf",
"valid": true,
"normalized": "11144477735"
},
{
"id": "bad",
"valid": false,
"error": "invalid_length"
}
]
}
# Only send the valid=true ids downstream → no KYC fee burned on malformed input
Os números
Provedores de KYC geralmente cobram por tentativa. Relatórios públicos do setor citam faixas típicas de USD 0,50 a 3,00+ por verificação de identidade, dependendo do volume, região e profundidade da verificação. Se uma parte dos seus inputs chega ao KYC com formato malformado — um CPF que falha no dígito verificador, um CNPJ com comprimento incorreto, um documento que não corresponde ao padrão do país — o custo da tentativa é cobrado de qualquer forma.
Filtrar formato upstream custa ordens de magnitude menos por chamada.
Não afirmamos um percentual de economia específico para o seu caso — a taxa de inputs malformados depende das suas fontes de dados. Recomendamos rodar o Validate em uma amostra dos seus inputs atuais para medir o seu número antes de decidir.
Não afirmamos um percentual de economia específico para o seu caso. A taxa de inputs malformados depende das suas fontes de dados. Meça antes de decidir.
LIMITACOES
O que o Normadata nao faz aqui
—O Normadata nao e KYC. Nao verifica identidade, nao consulta listas de sancoes nem confirma que o ID fiscal pertence a pessoa que esta enviando o formulario. Isso e o que seu provedor de KYC faz.
—O Normadata nao consulta nenhum cadastro governamental (Receita Federal, SEFAZ). Um CPF estruturalmente valido nao significa que o CPF esta cadastrado ou ativo.
PERGUNTAS FREQUENTES
Perguntas frequentes
O Normadata substitui Idwall, Unico ou Truora?
Nao. O Normadata roda antes do seu provedor de KYC como um gate de formato. Valida que o CPF ou CNPJ e estruturalmente correto antes de voce pagar por uma tentativa de KYC. Verificacao de identidade, prova de vida, autenticidade de documento — isso continua com seu provedor de KYC.
Quais identificadores o Normadata valida para pre-checagens de KYC?
CPF e CNPJ (Brasil), CUIT e CUIL (Argentina), RFC (Mexico), RUT (Chile e Uruguai), NIT (Colombia), RUC (Peru), CURP (Mexico). Todos com validacao de checksum onde aplicavel.
Integre o Normadata no seu stack
Acesso antecipado. Entre na lista e daremos acesso à API.