API CPF e CNPJ para Fintechs: KYC e Compliance Automatizado

# Python exemplo para KYC fintech
import requests
import asyncio
from datetime import datetime

class ValidadorKYC:
    def __init__(self, api_token, api_package):
        self.token = api_token
        self.package = api_package
        self.base_url = 'https://api.cpfcnpj.com.br'

    async def validar_onboarding_completo(self, dados_cliente):
        """
        Valida cliente completo para KYC regulatório
        Retorna: {aprovado: bool, motivo: str, score: float, dados: dict}
        """
        cpf = self._limpar_documento(dados_cliente['cpf'])

        try:
            # 1. Valida CPF contra Receita Federal
            validacao = await self._validar_cpf_receita(cpf)

            if not validacao['valido']:
                return self._criar_resposta(
                    False, 'CPF_INVALIDO',
                    'CPF não encontrado na base da Receita Federal',
                    score=0
                )

            if validacao['situacao'] != 'REGULAR':
                return self._criar_resposta(
                    False, 'CPF_IRREGULAR',
                    f"CPF {validacao['situacao']} - não permitido",
                    score=0
                )

            # 2. Cross-valida nome (KYC requirement)
            score_nome = self._calcular_score_nome(
                dados_cliente['nome'],
                validacao['nome']
            )

            if score_nome < 0.60:
                # Divergência alta - revisão manual obrigatória
                await self._registrar_caso_compliance({
                    'cpf': cpf,
                    'motivo': 'DIVERGENCIA_NOME',
                    'score_nome': score_nome,
                    'nome_declarado': dados_cliente['nome'],
                    'nome_oficial': validacao['nome'],
                    'prioridade': 'ALTA'
                })
                return self._criar_resposta(
                    False, 'REVISAR_MANUAL',
                    'Divergência de nome requer validação adicional',
                    score=score_nome * 100
                )

            # 3. Valida idade (18+ requirement)
            if 'data_nascimento' in validacao:
                idade = self._calcular_idade(validacao['data_nascimento'])
                if idade < 18:
                    return self._criar_resposta(
                        False, 'MENOR_IDADE',
                        'Cliente deve ter 18+ anos',
                        score=0
                    )

            # 4. Calcula score final KYC
            score_final = self._calcular_score_kyc({
                'score_nome': score_nome,
                'cpf_valido': True,
                'idade': idade if 'data_nascimento' in validacao else None
            })

            # 5. Registra log compliance (auditoria Bacen)
            await self._registrar_log_auditoria({
                'timestamp': datetime.utcnow(),
                'cpf': cpf,
                'resultado': 'APROVADO',
                'score_final': score_final,
                'regulamento': 'CIRCULAR_BACEN_3978',
                'dados_completos': validacao
            })

            return self._criar_resposta(
                True, 'APROVADO',
                'KYC aprovado automaticamente',
                score=score_final,
                dados=validacao
            )

        except Exception as e:
            # Erro crítico: não aprovar automaticamente
            return self._criar_resposta(
                False, 'ERRO_SISTEMA',
                'Validação automática indisponível - revisão manual',
                score=0
            )