# API de CPF para verificação de identidade em processos de assinatura digital > Saiba como usar API de CPF para verificar a identidade de signatários em processos de assinatura digital, garantindo validade jurídica e segurança. **Publicado:** 03/05/2025 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/api-cpf-verificacao-identidade-processos-assinatura-digital --- A API de CPF é usada em processos de assinatura digital para confirmar a identidade do signatário antes de liberar a assinatura — retornando nome completo, data de nascimento e gênero em ~900ms, com base nos dados da Receita Federal. Isso cria evidências de identificação que fortalecem a validade jurídica do documento e protegem contra fraudes de impostura. ## Introdução A assinatura digital se tornou o padrão para formalização de contratos, procurações, termos de aceite e documentos legais no Brasil. Com a [Lei 14.063/2020](https://www.iti.gov.br/legislacao/lei-14063-2020) e a crescente adoção de plataformas de assinatura eletrônica, a verificação de identidade do signatário ganhou importância central — tanto para garantir a validade jurídica da assinatura quanto para prevenir fraudes. O CPF é o principal identificador utilizado nesse processo. --- ## O cenário da assinatura digital no Brasil ### Tipos de assinatura eletrônica A Lei 14.063/2020 estabelece três tipos de assinatura eletrônica: * **Simples** — Qualquer forma eletrônica que identifique o signatário (e-mail, IP, código SMS). Não exige verificação rigorosa de identidade. * **Avançada** — Utiliza meios de autenticação que garantem a identificação do signatário e a integridade do documento. Pode utilizar certificado digital não ICP-Brasil ou autenticação Gov.br. * **Qualificada** — Utiliza certificado digital ICP-Brasil. Possui presunção de veracidade jurídica. ### Onde a validação de CPF se encaixa Para assinaturas simples e avançadas, a validação de CPF via API oferece uma camada adicional de verificação que fortalece a identificação do signatário. Para assinaturas qualificadas, a validação de CPF complementa a verificação feita pelo certificado digital. --- ## Por que validar CPF antes da assinatura ### 1. Confirmar identidade do signatário A validação de CPF confirma que o número informado pelo signatário pertence a uma pessoa real e que os dados cadastrais conferem. ### 2. Prevenir assinatura por terceiros Sem verificação de identidade, qualquer pessoa com acesso ao link de assinatura pode assinar em nome de outra. A validação de CPF cria uma barreira contra esse tipo de fraude. ### 3. Fortalecer a validade jurídica Em disputas judiciais, a comprovação de que o signatário teve sua identidade verificada via consulta a dados oficiais fortalece a validade da assinatura. ### 4. Compliance corporativo Empresas que exigem assinaturas em contratos de alto valor (financeiros, imobiliários, societários) precisam de evidências de que a identidade do signatário foi verificada. --- ## Fluxo de assinatura com validação de CPF ### Antes da assinatura 1. Signatário recebe o link do documento. 2. Signatário informa seu CPF. 3. Sistema consulta API de CPF para obter dados cadastrais. 4. Sistema exibe o nome completo retornado e solicita confirmação. 5. Signatário confirma e prossegue para a assinatura. 6. Sistema registra a validação como evidência de identificação. ### Resposta da API ```json { "success": true, "data": { "cpf": "12345678900", "name": "Beatriz Mendonça Lima", "nameUpper": "BEATRIZ MENDONÇA LIMA", "gender": "F", "birthDate": "11/02/1983", "day": 11, "month": 2, "year": 1983 } } ``` --- ## Implementação: verificação de signatário Exemplo em Python de verificação de identidade antes de permitir a assinatura: ```python import requests from datetime import datetime CPFHUB_API_KEY = 'SUA_CHAVE_DE_API' def verificar_signatario(cpf: str, nome_esperado: str, documento_id: str) -> dict: """ Verifica a identidade do signatário via CPF antes de permitir a assinatura. Registra a verificação como evidência. """ url = f'https://api.cpfhub.io/cpf/{cpf}' headers = { 'x-api-key': CPFHUB_API_KEY, 'Accept': 'application/json' } try: response = requests.get(url, headers=headers, timeout=10) resultado = response.json() except requests.RequestException as e: return { 'assinatura_permitida': False, 'motivo': f'Erro na verificacao: {str(e)}', 'acao': 'Tentar novamente' } if not resultado.get('success'): return { 'assinatura_permitida': False, 'motivo': 'CPF nao encontrado na base', 'acao': 'Solicitar ao signatario que verifique o CPF informado' } dados = resultado['data'] # Verificar nome nome_confere = nome_esperado.upper().strip() == dados['nameUpper'].strip() # Registrar evidência de verificação evidencia = { 'documento_id': documento_id, 'cpf_consultado': cpf, 'nome_retornado': dados['name'], 'nome_esperado': nome_esperado, 'nome_confere': nome_confere, 'nascimento': dados['birthDate'], 'timestamp': datetime.utcnow().isoformat(), 'metodo': 'API CPFHub.io' } if nome_confere: return { 'assinatura_permitida': True, 'signatario': dados['name'], 'evidencia': evidencia, 'acao': 'Prosseguir para assinatura' } return { 'assinatura_permitida': False, 'motivo': 'Nome do signatario diverge do cadastro oficial', 'nome_esperado': nome_esperado, 'nome_oficial': dados['name'], 'evidencia': evidencia, 'acao': 'Solicitar confirmacao ou correcao dos dados' } # Exemplo de uso resultado = verificar_signatario( cpf='12345678900', nome_esperado='Beatriz Mendonça Lima', documento_id='DOC-2025-001' ) print(resultado) ``` --- ## Evidências de identificação para validade jurídica A validação de CPF gera evidências que podem ser anexadas ao documento assinado: | Evidência | Descrição | | --- | --- | | CPF consultado | Número do CPF informado pelo signatário | | Nome retornado | Nome completo conforme registro oficial | | Data e hora | Timestamp da consulta | | Resultado | Match ou divergência | | IP do signatário | Endereço IP no momento da assinatura | | Método de verificação | API CPFHub.io | Essas evidências, combinadas com o registro da assinatura (hash do documento, certificado, logs), criam uma trilha de auditoria robusta. --- ## Cenários de assinatura digital com validação de CPF ### 1. Contratos imobiliários Contratos de compra e venda, locação e financiamento imobiliário exigem identificação rigorosa. A validação de CPF antes da assinatura confirma que o signatário é o titular declarado. ### 2. Contratos financeiros Empréstimos, financiamentos e abertura de contas envolvem assinatura de contratos com alto valor. A validação de CPF é uma exigência regulatória do BACEN. ### 3. Procurações Procurações outorgadas digitalmente devem identificar o outorgante com precisão. A validação de CPF previne que procurações sejam assinadas por impostores. ### 4. Termos de aceite e consentimento Termos de aceite da LGPD e consentimentos para tratamento de dados ganham mais força quando vinculados a um CPF validado. ### 5. Documentos societários Alterações contratuais, atas de reunião e resoluções de sócios exigem assinatura dos representantes legais. A validação de CPF confirma a identidade de cada signatário. --- ## Integração com plataformas de assinatura A validação de CPF pode ser integrada a plataformas de assinatura eletrônica existentes via webhook ou chamada de API no fluxo de assinatura: ```bash curl -X GET https://api.cpfhub.io/cpf/12345678900 \ -H "x-api-key: SUA_CHAVE_DE_API" \ -H "Accept: application/json" \ --max-time 10 ``` ### Fluxo de integração 1. Plataforma de assinatura recebe CPF do signatário. 2. Plataforma chama API CPFHub.io para validação. 3. Se validado, plataforma exibe confirmação e libera assinatura. 4. Se divergente, plataforma bloqueia e solicita correção. 5. Evidência de validação é registrada no envelope de assinatura. --- ## Comparativo de métodos de verificação | Método | Custo | Tempo | Força jurídica | Experiência do usuário | | --- | --- | --- | --- | --- | | Apenas e-mail + IP | Baixo | Instantâneo | Fraca | Fluida | | CPF validado via API | R$ 0,15 | ~900ms | Boa | Fluida | | CPF + documento + selfie | R$ 2-5 | 30-60s | Forte | Média | | Certificado digital ICP-Brasil | R$ 100-200/ano | 5-10s | Máxima | Complexa | A validação de CPF via API oferece o melhor equilíbrio entre custo, velocidade, experiência do usuário e força jurídica para a maioria dos cenários de assinatura eletrônica. --- ## Conformidade legal ### Lei 14.063/2020 A lei reconhece a assinatura eletrônica avançada, que exige meios de identificação do signatário. A validação de CPF via API atende a esse requisito. ### LGPD A consulta ao CPF para fins de verificação de identidade em assinatura de documentos é amparada pela base legal de execução de contrato. A CPFHub.io é 100% conforme à LGPD. ### MP 2.200-2/2001 A Medida Provisória que instituiu a ICP-Brasil reconhece a validade de documentos eletrônicos assinados com outros meios de comprovação de autoria, desde que admitidos pelas partes. --- ## Perguntas frequentes ### A API de CPF serve para assinaturas eletrônicas avançadas? Sim. A assinatura eletrônica avançada, prevista na Lei 14.063/2020, exige meios que identifiquem o signatário e garantam a integridade do documento. A consulta de CPF via API fornece o nome oficial e a data de nascimento do titular, gerando evidências auditáveis que atendem a esse requisito. O [ITI](https://www.iti.gov.br/) orienta que qualquer meio que garanta a autoria e integridade pode ser reconhecido. ### O que acontece se a API retornar dados divergentes do nome informado pelo signatário? O sistema deve bloquear a assinatura e solicitar que o signatário corrija os dados. A divergência pode indicar erro de digitação, uso de nome social diferente do nome civil ou tentativa de fraude. A evidência da divergência também deve ser registrada no envelope do documento para fins de auditoria. ### Qual é a latência típica da consulta de CPF no fluxo de assinatura? A API CPFHub.io responde em ~900ms, o que é imperceptível para o signatário dentro de um fluxo de assinatura onde outros processamentos já ocorrem. Implemente um timeout de 10 segundos e trate a falha com permissão temporária + flag de revisão para não bloquear o fluxo em caso de instabilidade. ### Como integrar a validação de CPF em uma plataforma de assinatura existente? A integração se dá por chamada GET a `https://api.cpfhub.io/cpf/{CPF}` com o header `x-api-key` no momento em que o signatário informa o documento. O plano gratuito oferece 50 consultas mensais sem cartão de crédito — ideal para validar a integração. Para produção, o plano Pro inclui 1.000 consultas por R$149/mês, com R$0,15 por consulta adicional sem bloqueio. ### Leia também - [Diferença entre validação de CPF e consulta de CPF: quando usar cada uma](https://cpfhub.io/blog/diferenca-entre-validacao-de-cpf-e-consulta-de-cpf-quando-usar-cada-uma) - [API de CPF grátis para desenvolvedores: como começar em 5 minutos](https://cpfhub.io/blog/api-cpf-gratis-desenvolvedores-comecar-5-minutos) - [Onboarding digital em fintechs: como validar CPF em menos de 30 segundos](https://cpfhub.io/blog/onboarding-digital-em-fintechs-como-validar-cpf-em-menos-de-30-segundos) - [KYC no Brasil: quais setores são obrigados a validar CPF por lei](https://cpfhub.io/blog/kyc-no-brasil-quais-setores-sao-obrigados-a-validar-cpf-por-lei) --- ## Conclusão A verificação de identidade via CPF é uma camada essencial para fortalecer a validade jurídica e a segurança de processos de assinatura digital. Com a API da CPFHub.io, cada signatário tem sua identidade confirmada em tempo real antes de assinar — criando evidências auditáveis que protegem todas as partes envolvidas. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/) — 50 consultas mensais gratuitas, sem cartão de crédito — e implemente verificação de identidade em seus contratos digitais ainda hoje.