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.