CASO DE USO
Seller onboarding: pré-validar antes de provisionar a conta
Cada seller que você manda pro KYC com dados malformados é um seat de KYC queimado. Cada conta provisionada com tax ID errado é uma conta que vai falhar no primeiro payout. A Normadata roda no signup do seller para que só cheguem records com formato válido ao stack downstream.
O PROBLEMA
O KYC cobra por seat independente de o dado ser válido
Os marketplaces tipicamente pagam por cada verificação KYC iniciada. Se o seller preencheu um CPF com DV errado, Sumsub/Idwall te faturam igual, mesmo que rejeitem no primeiro step.
CPF que passa pela regex mas falha no DV
O front valida "11 dígitos numéricos" mas não calcula o módulo-11. O seller termina o signup, você cria a conta, manda pro KYC, o KYC fatura, o KYC rejeita. Dinheiro jogado fora por validação que dava pra fazer client-side.
CUIT com prefixo errado para o tipo de entidade
Prefixos 30/33/34 são pessoas jurídicas, 20/23/24/27 são físicas. Um seller marca "empresa" mas preenche CUIT com prefixo de pessoa — o sistema cria conta empresa com dados de pessoa e tudo quebra no faturamento.
Email com domínio inexistente ou typo conhecido
gmal.com, hotmial.com, outloook.com. O seller digita do mobile e ninguém pega o erro. A conta fica ativa mas o seller nunca recebe o email de verificação.
POR QUE AS SOLUCOES PADRAO NAO SAO SUFICIENTES
Por que os validators de form não bastam
Regex client-side
Pega shape mas não pega DV, prefixos LATAM, nem typos de domínio. Falsos positivos em 5-15% das submissions.
Validação no step de KYC
Tarde demais — o seat de KYC já foi faturado. E o seller fica frustrado quando vê o erro depois de passar 4 steps do signup.
Validação no primeiro payout
Ainda mais tarde. A essa altura o seller já operou, gerou histórico, e o reverse do rail quebra a confiança dele.
COMO O NORMADATA AJUDA
Como o Normadata ajuda
POST /v1/validate/records com o payload completo do signup. Tax ID, conta bancária, endereço e nome validados em uma única request, com consistência e readiness, antes de criar a conta.
O país viaja em cada record (campo country). O endpoint checa consistência entre o país e o documento/conta do seller.
Bloqueie o submit se valid=false. Mostre o field específico que falhou (response.warnings tem o field path) — o seller corrige e tenta de novo no mesmo viewport.
VEJA EM ACAO
Veja em acao
# Pre-validate seller tax IDs at the signup form — one batch, multiple sellers
$ curl -X POST api.normadata.io/v1/validate/tax-ids \
-H "X-API-Key: nd_a8f3b2c1d4e5f6g7h8i9j0k1l2m3n4o5" \
-d '{"items":[
{"id":"ar","country":"AR","type":"cuit","value":"30-71234567-9"},
{"id":"br","country":"BR","type":"cnpj","value":"11.222.333/0001-81"}
]}'
{
"results": [
{ "id": "ar", "valid": true, "normalized": "30712345679" },
{ "id": "br", "valid": true, "normalized": "11222333000181" }
]
}
# One schema for AR CUIT, BR CNPJ, CL RUT, CO NIT — reject before provisioningLIMITACOES
O que a Normadata não faz em seller onboarding
—Não substitui o KYC. A Normadata é pré-validação estrutural; Sumsub/Idwall/Metamap fazem verificação de identidade regulada. São complementares.
—Não verifica se o seller está autorizado a operar na LATAM. Isso é trabalho do compliance officer do seu marketplace.
PERGUNTAS FREQUENTES
Perguntas frequentes
Quanto reduz o custo de KYC?
Depende da qualidade do seu funnel. Marketplaces com onboarding mobile-first tipicamente veem 10-25% de inputs com erros estruturais. Filtrá-los antes do KYC reduz o seat-cost proporcionalmente.
Detecta o país sem o seller escolher?
O país é um campo obrigatório em cada item; não é inferido. O endpoint valida o documento contra esse país e reporta inconsistências.
Integre o Normadata no seu stack
Acesso antecipado. Entre na lista e daremos acesso à API.