API de Verificação de Número de Telefone no Brasil (PT-BR)

Integrar usuários no Brasil significa confirmar que eles são quem dizem ser. Verifica dados inseridos com dados de telefone de operadoras de telefonia móvel. Um documento ou um dado digitado apenas prova que o dado existe — não que seja genuíno ou pertença à pessoa à sua frente. A Verificação de Telefone no Brasil preenche essa lacuna, verificando os dados com dados de operadoras de telefonia móvel. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais vantagens:

• O que é verificado — A Verificação de Telefone no Brasil valida a titularidade do número de telefone com base em dados de operadoras de telefonia móvel.
• O que você recebe — um match_type normalizado mais resultados em nível de campo que você pode direcionar diretamente para a lógica de aprovação / revisão / rejeição.
• Por que isso importa — Confirmar que um número de telefone pertence à pessoa indicada impede a tomada de contas e fraudes baseadas em SIM antes que comecem.
• Como usá-lo — um POST para o endpoint de validação de banco de dados da Didit. R$0,40 por consulta conclusiva, resultados em segundos.

O que a Verificação de Telefone no Brasil valida

Verifica dados inseridos com dados de telefone de operadoras de telefonia móvel. A Didit expõe isso através de um único endpoint para que você possa verificar os dados enviados com dados de operadoras de telefonia móvel e receber um resultado estruturado e normalizado — não um despejo bruto de registros que você precisa analisar sozinho.

Uma resposta conclusiva retorna os source_data correspondentes e um bloco de validation por campo, para que seu motor de risco obtenha um veredicto claro e legível por máquina.

Por que isso importa

Confirmar que um número de telefone pertence à pessoa indicada impede a tomada de contas e fraudes baseadas em SIM antes que comecem.

Para empresas regulamentadas no Brasil — fintechs, plataformas de criptomoedas, credores, marketplaces e operadores de jogos — verificar com uma fonte autoritativa produz um registro defensável e auditável de que a identidade foi confirmada na fonte, e não apenas capturada de um formulário ou foto.

Detalhes técnicos

A Didit expõe este serviço através do endpoint unificado de validação de banco de dados. É um único POST — nenhum SDK necessário.

Endpoint

POST /v3/database-validation/

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código de país ISO 3166-1 alpha-3. Use BRA.
services	string	Sim	Identificador de serviço. Use bra_phone.
first_name	string	Sim	Nome.
last_name	string	Sim	Sobrenome.
address	string	Sim	Endereço.
phone	string	Sim	Telefone.

Exemplo de solicitação

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: SUA_CHAVE_API" \
  -F "issuing_state=BRA" \
  -F "services=bra_phone" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "address=123 Sample Street, Sample City, 10001" \
  -F "phone=+15550101000"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_phone",
      "service_name": "Brasil - Telefone",
      "source_data": {
        "address": "123 Sample Street",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturamento

• Latência: normalmente alguns segundos.
• Custo: R$0,40 por consulta conclusiva. Você é cobrado apenas por resultados conclusivos — sem cobrança por inatividade da fonte, campos ausentes ou rejeições pré-fonte.
• Confiabilidade: executa na infraestrutura da Didit com uma meta de tempo de atividade trimestral de 99,9%.

Casos de uso

• Fintechs e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito no Brasil.
• Cripto e Web3 — atenda aos requisitos de integração VASP com prova de identidade de fonte autoritativa.
• Empréstimos — reduza a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
• Marketplaces e plataformas de freelancers — verifique os usuários com base em dados autoritativos, não apenas em um formulário auto-declarado.
• iGaming — atenda aos requisitos de verificação de identidade e elegibilidade para jogadores no Brasil com um registro auditável.

Como integrar com a Didit

Você pode executar a Verificação de Telefone no Brasil de duas maneiras:

1. Somente API direta. Este serviço é executado através da API, e não do construtor de fluxo de trabalho sem código.
2. API direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=bra_phone. Leia match_type e o bloco de validation por campo para direcionar sua lógica de aprovação / revisão / rejeição.

Cada conta Didit inclui 500 verificações gratuitas por mês, para que você possa testar todo o fluxo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação de Telefone no Brasil confirma?

Ele valida os dados enviados com dados de operadoras de telefonia móvel e retorna um resultado de correspondência normalizado, para que você saiba se a titularidade do número de telefone existe na fonte autoritativa e quais campos corresponderam.

O que acontece se a fonte estiver temporariamente indisponível?

Você não será cobrado. A cobrança se aplica apenas a resultados conclusivos — inatividade da fonte, campos ausentes e rejeições pré-fonte são gratuitas.

Quão rápida é a verificação?

A validação do banco de dados normalmente retorna em alguns segundos, para que se encaixe em um fluxo de integração em tempo real.

Eu preciso de um SDK?

Não. A verificação é um único POST HTTPS para um endpoint.

Pronto para começar?

Valide a titularidade do seu primeiro número de telefone no Brasil hoje.

• Leia a referência da API: Verificação de Telefone no Brasil
• Veja todas as validações de banco de dados: Preços e cobertura da Validação de Banco de Dados
• Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, grátis.