CASO DE USO
Valide destinatarios de pagamento antes da transferencia
Um pagamento reprovado no Brasil nao e apenas um problema de experiencia do usuario. Gera tarifas bancarias, re-entrada manual, ciclos de conciliacao e alertas de compliance. A maioria das falhas e prevenivel: o numero de conta tem um erro de checksum, o CPF nao corresponde ao formato, ou um digito foi transposto. O Normadata valida os dados do destinatario antes que a instrucao de transferencia saia do sistema.
O PROBLEMA
Pagamentos reprovados sao caros para recuperar
Estimativas do setor para reprocessamento de pagamentos reprovados variam de R$25 a R$120 por ocorrencia, considerando tarifas de devolucao bancaria, intervencao manual e overhead de conciliacao. Em escala, o custo se multiplica.
Formatos de conta especificos por pais
CPF (Brasil, 11 digitos com dois digitos verificadores), CNPJ (Brasil, 14 digitos com dois digitos verificadores), IBAN (internacional, comprimento variavel). Cada formato tem seu proprio algoritmo de validacao. Regex nao cobre o passo de checksum — uma string de 11 digitos que falha o calculo do CPF e estruturalmente errada mas passa uma verificacao basica de comprimento.
Divergencia de ID fiscal no nivel do destinatario
Alguns rails de transferencia exigem que o ID fiscal do destinatario corresponda ao titular registrado da conta. Um CPF sintaticamente valido mas que referencia o tipo de contribuinte incorreto pode causar a rejeicao da transferencia pelo banco.
Erros de digitacao detectados tarde demais
Um unico digito transposto em um CPF ou CNPJ e sintaticamente plausivel mas invalido no checksum. Sem um gate de formato, esse erro chega ao processador de pagamentos, dispara uma rejeicao e entra em uma fila manual — horas ou dias depois.
POR QUE AS SOLUCOES PADRAO NAO SAO SUFICIENTES
Por que as equipes constroem internamente — e por que isso falha
Validadores com regex
O regex pode verificar comprimento e conjunto de caracteres mas nao pode verificar o digito de checksum. CPF e CNPJ tem dois digitos verificadores cada. Um regex que aprova um CPF malformado vai deixar transferencias invalidas passarem.
Bibliotecas open source
A maioria dos validadores de contas bancarias do Brasil em npm/PyPI cobre um ou dois paises e raramente sao atualizados quando os bancos mudam codigos de roteamento ou pesos de algoritmo. Manter forks e trabalho operacional continuo.
Verificar apos a transferencia falhar
Confiar no processador de pagamentos para detectar erros de formato significa que o erro aparece apos o debito ja ter sido iniciado. Nesse ponto voce ja tem tarifas, um job reprovado e trabalho manual de nova tentativa.
COMO O NORMADATA AJUDA
Como o Normadata ajuda
Valide o formato e checksum de CPF, CNPJ e IBAN com uma unica chamada de API antes de construir a instrucao de transferencia. O Normadata retorna valid, normalized e o tipo de identificador — gate em valid=true antes de chamar seu provedor de pagamentos.
Valide os IDs fiscais do destinatario (CPF, CNPJ, CUIT, RFC, RUT) na mesma chamada. Detecte divergencias de tipo de contribuinte (pessoa fisica vs. juridica) antes que cheguem ao banco.
Use o endpoint suggest para detectar e mostrar possiveis erros de digitacao ao usuario no momento da entrada de dados. Detecte o digito transposto antes que o registro seja salvo.
VEJA EM ACAO
Veja em acao
# Validate a batch of recipient accounts before initiating payouts
$ curl -X POST api.normadata.io/v1/validate/accounts \
-H "X-API-Key: nd_a8f3b2c1d4e5f6g7h8i9j0k1l2m3n4o5" \
-d '{"items":[
{"id":"1","country":"AR","type":"cbu","value":"0170099220000067802779"},
{"id":"2","country":"BR","type":"pix","value":"111.444.777-35"}
]}'
{
"results": [
{
"id": "1",
"country": "AR",
"type": "cbu",
"valid": true,
"checksum_valid": true,
"bank_name": "Galicia"
},
{
"id": "2",
"valid": true,
"checksum_valid": true
}
]
}
# Same endpoint for 1 or N (up to 1,000 per request)
# Each result carries the id you sent — correlate by it, then release the payoutLIMITACOES
O que o Normadata nao faz aqui
—O Normadata nao verifica que a conta bancaria existe de fato ou pertence ao destinatario informado. Validade de formato nao e verificacao de titularidade de conta.
—O Normadata nao se integra com o Bacen, Banxico ou nenhuma API de banco central. Apenas valida formato e checksum.
PERGUNTAS FREQUENTES
Perguntas frequentes
O Normadata pode confirmar que um CPF pertence a uma pessoa especifica?
Nao. O Normadata valida que o CPF e estruturalmente correto (11 digitos, checksum valido). Nao consulta a Receita Federal nem nenhum sistema bancario para confirmar titularidade ou status da conta.
O Normadata suporta validacao de PIX?
O Normadata valida os tipos de chave PIX que sao identificadores estruturados: CPF (11 digitos), CNPJ (14 digitos) e IBAN. Para chaves PIX de email e telefone, a validacao de formato segue as regras padrao de email e E.164.
Integre o Normadata no seu stack
Acesso antecipado. Entre na lista e daremos acesso à API.