Como Automatizar KYC no Brasil via API (2026)
Know Your Customer (KYC) é obrigatório para fintechs, bancos, corretoras e qualquer empresa regulada no Brasil. Este guia mostra como montar um fluxo de KYC automatizado usando APIs de dados públicos.
O que um fluxo de KYC precisa verificar?
Um KYC completo no Brasil tipicamente valida: identidade (CPF na Receita Federal), situação cadastral, endereço, exposição política (PEP), presença em listas de sanções (CEIS, CNEP, OFAC, ONU, UE), antecedentes criminais, processos judiciais, e score de crédito.
Para pessoa jurídica, adiciona-se: dados de CNPJ, quadro societário (QSA), beneficiário final, regularidade fiscal (CND, FGTS, PGFN) e due diligence dos sócios individualmente.
Montando o fluxo com FonteData
A FonteData agrega 108+ fontes em uma API REST unificada, permitindo orquestrar todo o fluxo de KYC com uma única integração e uma única API key.
KYC Pessoa Física — Checklist de endpoints
| Verificação | Endpoint | Custo |
|---|---|---|
| Identidade (Receita Federal) | /receita-federal-pf/{cpf} |
R$ 0,54 |
| PEP (exposição política) | /pep-exposicao/{cpf} |
R$ 0,54 |
| PEP estendida | /pep-estendida/{cpf} |
R$ 0,54 |
| Sanções CEIS (CGU) | /ceis-sancoes/{cpf} |
R$ 0,54 |
| OFAC (EUA) | /ofac-sancoes/{nome} |
R$ 0,54 |
| ONU sanções | /onu-sancoes/{cpf} |
R$ 0,54 |
| UE sanções | /eu-sancoes/{cpf} |
R$ 1,95 |
| Antecedentes criminais | /antecedentes-criminais/{cpf} |
R$ 0,54 |
| Processos judiciais | /processos-agrupada/{cpf} |
R$ 1,65 |
| Mandados de prisão | /cnj-mandados-prisao/{cpf} |
R$ 1,08 |
| Situação eleitoral | /tse-situacao/{cpf} |
R$ 0,54 |
Custo total do KYC PF completo: ~R$ 9,00 por pessoa.
KYC Pessoa Jurídica — Checklist de endpoints
| Verificação | Endpoint | Custo |
|---|---|---|
| CNPJ + QSA | /receita-federal-pj-qsa/{cnpj} |
R$ 4,20 |
| Beneficiário final | /beneficiario-final/{cnpj} |
R$ 2,16 |
| CEIS (CGU) | /ceis-sancoes/{cnpj} |
R$ 0,54 |
| CNEP (CGU) | /cnep-sancoes/{cnpj} |
R$ 0,54 |
| Trabalho forçado | /trabalho-forcado/{cnpj} |
R$ 0,54 |
| PGFN dívida ativa | /pgfn-devedores/{cnpj} |
R$ 0,54 |
| CND débitos | /cnd-debitos/{cnpj} |
R$ 0,54 |
| CNDT trabalhista | /tst-cndt/{cnpj} |
R$ 0,54 |
| FGTS | /fgts-regularidade/{cnpj} |
R$ 0,54 |
| Processos | /processos-completa/{cnpj} |
R$ 4,95 |
| OFAC | /ofac-sancoes/{nome} |
R$ 0,54 |
| KYC de cada sócio (PF) | Endpoints PF acima | ~R$ 9,00/sócio |
Custo total do KYC PJ (sem sócios): ~R$ 15,09 por empresa.
Exemplo: fluxo automatizado em Python
import requests
from typing import List, Dict
API_KEY = "fd_live_SUA_CHAVE"
BASE = "https://app.fontedata.com/api/v1/consulta"
def kyc_pf(cpf: str) -> Dict:
"""Executa KYC completo para pessoa física."""
cpf = cpf.replace(".", "").replace("-", "")
checks = {
"identidade": f"receita-federal-pf/{cpf}",
"pep": f"pep-exposicao/{cpf}",
"ceis": f"ceis-sancoes/{cpf}",
"ofac": f"ofac-sancoes/{cpf}",
"antecedentes": f"antecedentes-criminais/{cpf}",
"processos": f"processos-agrupada/{cpf}",
}
results = {}
for check_name, endpoint in checks.items():
resp = requests.get(
f"{BASE}/{endpoint}",
headers={"X-API-Key": API_KEY}
)
results[check_name] = {
"status": resp.status_code,
"data": resp.json() if resp.ok else None,
"cost": resp.headers.get("X-Request-Cost", "N/A")
}
return results
# Executar
resultado = kyc_pf("123.456.789-00")
Por que usar uma API agregadora?
Sem uma API agregadora, um fluxo de KYC exige integração individual com cada órgão público — Receita Federal, CGU, PGFN, TST, TSE, Banco Central, OFAC, etc. Cada um tem formatos, autenticações e disponibilidades diferentes.
Uma plataforma como a FonteData centraliza 108+ fontes em uma interface única (REST + JSON + API key), reduzindo o tempo de integração de semanas para minutos e eliminando a necessidade de manutenção de múltiplas conexões.
Compliance e LGPD
Consultas de KYC via API são compatíveis com a LGPD quando realizadas com base legal adequada. A FonteData opera com base no legítimo interesse (Art. 7º, IX) e utiliza exclusivamente fontes públicas oficiais e provedores autorizados. O DPO pode ser contatado em dpo@fontedata.com.