API de Verificação de Telefone na Espanha (PT-BR-1)

Integrar usuários na Espanha significa confirmar que eles são quem afirmam ser. Verifica os dados de entrada com os dados de telefone das operadoras de rede móvel. Um documento ou um detalhe digitado apenas prova que os dados existem — não que são genuínos ou pertencem à pessoa à sua frente. A Verificação de Telefone 2 na Espanha preenche essa lacuna verificando os dados em relação aos dados da operadora de rede móvel. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais pontos:

• O que verifica — A Verificação de Telefone 2 na Espanha valida a titularidade do número de telefone em relação aos dados da operadora de rede 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 é importante — Confirmar que um número de telefone pertence à pessoa declarada bloqueia a tomada de conta e a fraude baseada em SIM antes que ela comece.
• Como usar — um POST para o endpoint de validação de banco de dados da Didit. US$0,77 por consulta conclusiva, resultados em segundos.

O que a Verificação de Telefone 2 na Espanha valida

Verifica os dados de entrada com os dados de telefone das operadoras de rede móvel. A Didit o expõe através de um único endpoint para que você possa verificar os dados enviados em relação aos dados da operadora de rede móvel e receber um resultado estruturado e normalizado — não um despejo de registro bruto 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 veredito claro e legível por máquina.

Por que é importante

Confirmar que um número de telefone pertence à pessoa declarada bloqueia a tomada de conta e a fraude baseada em SIM antes que ela comece.

Para empresas regulamentadas na Espanha — fintechs, plataformas de cripto, credores, mercados e operadores de jogos — a verificação contra uma fonte autoritativa produz um registro defensável e auditável de que a identidade foi confirmada na fonte, não apenas capturada de um formulário ou de uma 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 do país ISO 3166-1 alfa-3. Use ESP.
services	string	Sim	Identificador de serviço. Use esp_phone_2.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Último nome.
address	string	Sim	Endereço.
phone	string	Sim	Telefone.
date_of_birth	string	Não	Data de nascimento (verificação cruzada opcional).

Exemplo de solicitação

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ESP" \
  -F "services=esp_phone_2" \
  -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": "ESP",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "esp_phone_2",
      "service_name": "Spain Phone 2",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturamento

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

Casos de uso

• Fintech e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito na Espanha.
• Cripto e Web3 — cumpra os 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 gig — verifique usuários em relação a dados autoritativos, não apenas um formulário auto-relatado.
• iGaming — satisfaça verificações de identidade e elegibilidade para jogadores na Espanha com um rastro auditável.

Como integrar com a Didit

Você pode executar a Verificação de Telefone 2 na Espanha de duas maneiras:

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

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

Perguntas frequentes

O que a Verificação de Telefone 2 na Espanha confirma?

Ela valida os dados enviados em relação aos dados da operadora de rede 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 é cobrado. A cobrança se aplica apenas a resultados conclusivos — tempo de inatividade da fonte, campos ausentes e rejeições pré-fonte são gratuitos.

Qual a velocidade da verificação?

A validação do banco de dados geralmente retorna em alguns segundos, então se encaixa em um fluxo de integração em tempo real.

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 na Espanha hoje.

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