APIs de CPF para empresas de seguros de vida e previdência

APIs de CPF são essenciais para seguradoras de vida e previdência: elas confirmam a identidade do segurado na contratação, validam os CPFs dos beneficiários designados e agilizam o pagamento de sinistros ao eliminar ambiguidades cadastrais. A CPFHub.io oferece essa verificação com resposta em ~900ms e conformidade total com a LGPD.

Introdução

O mercado de seguros de vida e previdência privada no Brasil movimenta centenas de bilhões de reais por ano. Seguradoras precisam identificar com precisão tanto os segurados quanto os beneficiários designados nas apólices, pois qualquer inconsistência nos dados cadastrais pode gerar problemas sérios -- desde a negativa de pagamento de sinistros até disputas judiciais entre herdeiros.

O CPF é o identificador fundamental nesse contexto. Ele vincula o segurado à sua apólice e os beneficiários aos seus direitos. A validação de CPF via API garante que os dados são consistentes desde a contratação até o eventual pagamento do sinistro. O CPFHub.io entrega essa verificação em ~900ms, com dados atualizados e plano gratuito de 50 consultas mensais para começar sem cartão de crédito.

O CPF nos processos de seguros e previdência

Contratação da apólice

Na contratação de um seguro de vida, o CPF do segurado é exigido para a análise de risco, emissão da apólice e registro junto à SUSEP (Superintendência de Seguros Privados).

Designação de beneficiários

Cada beneficiário designado na apólice deve ser identificado pelo CPF. Isso evita ambiguidades e disputas sobre quem tem direito ao capital segurado.

Pagamento de sinistros

No momento do sinistro, a seguradora precisa confirmar a identidade dos beneficiários antes de efetuar o pagamento. O CPF é o dado principal para essa verificação.

Planos de previdência

Em planos PGBL e VGBL, o CPF do participante é vinculado ao plano para fins de contribuições, resgates e benefício fiscal.

Portabilidade

A portabilidade entre planos de previdência exige a identificação precisa do participante por meio do CPF.

Fraudes no setor de seguros de vida

Contratação com dados falsos

Golpistas contratam seguros usando CPFs de terceiros, pagam algumas parcelas e simulam sinistros para receber a indenização.

Beneficiários fantasmas

A designação de beneficiários com CPFs inexistentes ou inválidos pode ser parte de esquemas de fraude para desviar o capital segurado.

Falsificação de identidade em sinistros

Pessoas que se apresentam como beneficiários com CPFs falsos para receber indenizações indevidas.

Acumulação indevida de apólices

O mesmo segurado contrata múltiplas apólices em diferentes seguradoras usando variações de dados cadastrais, visando receber indenizações acumuladas.

Implementação com Python

import requests
from datetime import datetime

CPFHUB_API_KEY = "sua_api_key_aqui"
CPFHUB_BASE_URL = "https://api.cpfhub.io/cpf"
TIMEOUT_SECONDS = 10

def validar_segurado_e_beneficiarios(segurado: dict,
    beneficiarios: list) -> dict:
    """
    Valida o CPF do segurado e de todos os beneficiários
    antes da emissão da apólice.
    """
    resultados = {"segurado": None, "beneficiarios": [], "aprovado": True}

    # Validar segurado
    resultado_segurado = consultar_e_validar(
    segurado["cpf"], segurado["nome"]
    )
    resultados["segurado"] = resultado_segurado

    if not resultado_segurado["valido"]:
    resultados["aprovado"] = False

    # Validar beneficiários
    for beneficiario in beneficiarios:
    resultado_benef = consultar_e_validar(
    beneficiario["cpf"], beneficiario["nome"]
    )
    resultado_benef["percentual"] = beneficiario.get("percentual", 0)
    resultados["beneficiarios"].append(resultado_benef)

    if not resultado_benef["valido"]:
    resultados["aprovado"] = False

    return resultados

def consultar_e_validar(cpf: str, nome: str) -> dict:
    """Consulta a API e valida CPF contra o nome informado."""
    cpf_limpo = cpf.replace(".", "").replace("-", "")

    if len(cpf_limpo) != 11 or not cpf_limpo.isdigit():
    return {"valido": False, "cpf": cpf, "motivo": "Formato inválido"}

    headers = {
    "x-api-key": CPFHUB_API_KEY,
    "Accept": "application/json"
    }

    try:
    response = requests.get(
    f"{CPFHUB_BASE_URL}/{cpf_limpo}",
    headers=headers,
    timeout=TIMEOUT_SECONDS
    )
    response.raise_for_status()
    resultado = response.json()
    except requests.exceptions.Timeout:
    return {"valido": False, "cpf": cpf, "motivo": "Timeout"}
    except requests.exceptions.RequestException as e:
    return {"valido": False, "cpf": cpf, "motivo": str(e)}

    if not resultado.get("success"):
    return {"valido": False, "cpf": cpf, "motivo": "CPF não encontrado"}

    dados = resultado["data"]
    nome_api = dados.get("nameUpper", "").strip()
    nome_informado = nome.strip().upper()

    if nome_api != nome_informado:
    return {
    "valido": False,
    "cpf": cpf,
    "motivo": "Nome divergente",
    "nome_base": nome_api,
    "nome_informado": nome_informado
    }

    return {
    "valido": True,
    "cpf": dados["cpf"],
    "nome": dados["name"],
    "genero": dados["gender"],
    "data_nascimento": dados["birthDate"]
    }

# Exemplo de uso
segurado = {"cpf": "123.456.789-09", "nome": "Paulo Roberto Martins"}

beneficiarios = [
    {"cpf": "987.654.321-00", "nome": "Maria Luísa Martins", "percentual": 50},
    {"cpf": "456.789.123-45", "nome": "Lucas Martins Silva", "percentual": 50}
]

resultado = validar_segurado_e_beneficiarios(segurado, beneficiarios)

if resultado["aprovado"]:
    print("Todos os CPFs validados -- apólice pode ser emitida")
    print(f"Segurado: {resultado['segurado']['nome']}")
    for b in resultado["beneficiarios"]:
    print(f" Beneficiário: {b['nome']} ({b['percentual']}%)")
else:
    print("Problemas encontrados:")
    if not resultado["segurado"]["valido"]:
    print(f" Segurado: {resultado['segurado']['motivo']}")
    for b in resultado["beneficiarios"]:
    if not b["valido"]:
    print(f" Beneficiário {b['cpf']}: {b['motivo']}")

Consulta via cURL

curl -X GET "https://api.cpfhub.io/cpf/12345678909" \
    -H "x-api-key: sua_api_key_aqui" \
    -H "Accept: application/json" \
    --max-time 10

Resposta:

{
    "success": true,
    "data": {
    "cpf": "123.456.789-09",
    "name": "Paulo Roberto Martins",
    "nameUpper": "PAULO ROBERTO MARTINS",
    "gender": "M",
    "birthDate": "18/02/1970",
    "day": "18",
    "month": "02",
    "year": "1970"
    }
}

Validação no pagamento de sinistros

O momento mais crítico para a validação de CPF no seguro de vida é o pagamento do sinistro. A seguradora deve confirmar a identidade de cada beneficiário antes de liberar os valores.

const axios = require("axios");

const CPFHUB_API_KEY = "sua_api_key_aqui";
const CPFHUB_BASE_URL = "https://api.cpfhub.io/cpf";

async function validarBeneficiarioSinistro(cpfBeneficiario, nomeBeneficiario,
    numeroApolice, valorIndenizacao) {
    const cpfLimpo = cpfBeneficiario.replace(/\D/g, "");

    try {
    const response = await axios.get(`${CPFHUB_BASE_URL}/${cpfLimpo}`, {
    headers: {
    "x-api-key": CPFHUB_API_KEY,
    Accept: "application/json"
    },
    timeout: 10000
    });

    const resultado = response.data;

    if (!resultado.success) {
    return {
    liberado: false,
    motivo: "CPF do beneficiário não encontrado",
    acao: "Solicitar documentação adicional"
    };
    }

    const dados = resultado.data;
    const nomeApi = dados.nameUpper;
    const nomeComparacao = nomeBeneficiario.toUpperCase().trim();

    if (nomeApi !== nomeComparacao) {
    return {
    liberado: false,
    motivo: "Nome do beneficiário diverge do CPF",
    acao: "Encaminhar para análise antifraude"
    };
    }

    return {
    liberado: true,
    beneficiario: {
    cpf: dados.cpf,
    nome: dados.name,
    dataNascimento: dados.birthDate
    },
    apolice: numeroApolice,
    valor: valorIndenizacao,
    validadoEm: new Date().toISOString()
    };
    } catch (error) {
    return {
    liberado: false,
    motivo: error.code === "ECONNABORTED" ? "Timeout" : error.message,
    acao: "Tentar novamente ou validar manualmente"
    };
    }
}

// Exemplo de uso
(async () => {
    const resultado = await validarBeneficiarioSinistro(
    "987.654.321-00",
    "Maria Luísa Martins",
    "APL-2025-00123",
    250000.00
    );

    if (resultado.liberado) {
    console.log(`Pagamento liberado para: ${resultado.beneficiario.nome}`);
    console.log(`Valor: R$ ${resultado.valor.toFixed(2)}`);
    } else {
    console.log(`Pagamento bloqueado: ${resultado.motivo}`);
    console.log(`Ação: ${resultado.acao}`);
    }
})();

Uso da data de nascimento na análise de risco

A data de nascimento retornada pela API do CPFHub pode ser utilizada na análise atuarial do seguro de vida. A idade do segurado é um dos principais fatores de precificação, e a confirmação da data de nascimento via API ajuda a evitar fraudes onde segurados declaram idades menores para obter prêmios mais baixos.

Boas práticas para seguradoras

• Validação na proposta -- Valide CPF e dados do segurado antes de aceitar a proposta de seguro.
• Verificação de beneficiários -- Confirme o CPF de todos os beneficiários designados, não apenas do segurado.
• Revalidação em sinistros -- No momento do pagamento do sinistro, revalide o CPF do beneficiário para garantir que os dados continuam consistentes.
• Integração com sistemas atuariais -- Use a data de nascimento validada para alimentar os modelos atuariais de precificação.
• Conformidade com SUSEP -- Mantenha registros de todas as validações para auditorias da SUSEP.

Perguntas frequentes

O que é necessário para implementar validação de CPF neste contexto?

A validação de CPF exige uma chamada à API com o número do documento e a chave de autenticação. A CPFHub.io retorna o status do CPF, nome do titular e data de nascimento em ~900ms, permitindo a verificação em tempo real durante o cadastro ou transação.

A API CPFHub.io funciona para todos os volumes de consulta?

Sim. O plano gratuito oferece 50 consultas por mês sem cartão de crédito — ideal para testes e projetos pequenos. Para volumes maiores, o plano Pro inclui 1.000 consultas mensais por R$149. Se o limite for ultrapassado, a API não bloqueia: cobra R$0,15 por consulta adicional.

Como garantir conformidade com a LGPD ao usar uma API de CPF?

Use o CPF apenas para a finalidade declarada ao titular, armazene apenas o necessário (não guarde o CPF cru se um token bastar), implemente controle de acesso aos logs de consulta e documente a base legal para o tratamento. A ANPD orienta que dados de identificação devem ser tratados com o princípio da necessidade.

Quanto tempo leva para integrar a API CPFHub.io?

A integração básica leva menos de 30 minutos: crie uma conta em cpfhub.io, gere a API key no painel e faça uma chamada GET para https://api.cpfhub.io/cpf/{CPF} com o header x-api-key. A documentação inclui exemplos em Python, Node.js, PHP, Java e outras linguagens.

Conclusão

A validação de CPF via API é uma camada de segurança indispensável para seguradoras de vida e empresas de previdência. Ela protege contra fraudes na contratação, garante a correta designação de beneficiários e agiliza o pagamento de sinistros. Com o CPFHub.io, sua equipe integra a validação em menos de 30 minutos e escala sem interrupções conforme o volume cresce.

Cadastre-se em cpfhub.io — 50 consultas mensais gratuitas, sem cartão de crédito — e comece hoje mesmo.