API de Verificação Telefónica em França (PT-PT)
Valide a titularidade de números de telefone franceses contra dados de operadoras de rede móvel em tempo real, faturado apenas em resultados conclusivos. Endpoint, parâmetros, esquema de resposta, preços e integração.

Integrar utilizadores em França significa confirmar que são quem afirmam ser. Verifica os dados inseridos com os dados telefónicos 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 Telefónica em França preenche essa lacuna, verificando os dados com os 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 Telefónica em França valida a titularidade do número de telefone com os dados da operadora de rede móvel.
- O que é devolvido — um
match_typenormalizado, mais resultados ao nível do campo que pode encaminhar diretamente para a lógica de aprovar / rever / rejeitar. - Porquê é importante — Confirmar que um número de telefone pertence à pessoa declarada bloqueia a apropriação de conta e a fraude baseada em SIM antes que comece.
- Como usar — um
POSTpara o endpoint de validação de base de dados da Didit. 0,67$ por consulta conclusiva, resultados em segundos.
O que a Verificação Telefónica em França valida
Verifica os dados inseridos com os dados telefónicos das operadoras de rede móvel. A Didit expõe-no através de um único endpoint para que possa verificar os dados submetidos com os dados da operadora de rede móvel e receber um resultado estruturado e normalizado — não um despejo de registo bruto que tenha de analisar você mesmo.
Uma resposta conclusiva devolve os source_data correspondentes e um bloco validation por campo, para que o seu motor de risco obtenha um veredito claro e legível por máquina.
Porquê é importante
Confirmar que um número de telefone pertence à pessoa declarada bloqueia a apropriação de conta e a fraude baseada em SIM antes que comece.
Para empresas reguladas em França — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — a verificação contra uma fonte autoritária produz um registo defensável e auditável de que a identidade foi confirmada na fonte, e 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 base de dados. É um único POST — não é necessário SDK.
Endpoint
POST /v3/database-validation/
Parâmetros de pedido
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
issuing_state | string | Sim | Código de país ISO 3166-1 alpha-3. Use FRA. |
services | string | Sim | Identificador de serviço. Use fra_phone. |
first_name | string | Sim | Primeiro nome. |
last_name | string | Sim | Último nome. |
phone | string | Sim | Telefone. |
date_of_birth | string | Não | Data de nascimento (verificação cruzada opcional). |
address | string | Não | Morada (verificação cruzada opcional). |
Exemplo de pedido
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=FRA" \
-F "services=fra_phone" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "phone=+15550101000"
Exemplo de resposta (correspondência conclusiva)
{
"request_id": "req_01H...",
"status": "Approved",
"issuing_state": "FRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "fra_phone",
"service_name": "France Phone",
"source_data": {
"address": "123 Sample Street",
"date_of_birth": "1990-01-01",
"first_name": "John",
"last_name": "Doe"
},
"validation": {
"full_name": "full_match"
}
}
]
}
Desempenho e faturação
- Latência: tipicamente alguns segundos.
- Custo: 0,67$ por consulta conclusiva. É faturado apenas em resultados conclusivos — sem cobrança por tempo de inatividade da fonte, campos em falta ou rejeições pré-fonte.
- Fiabilidade: funciona na infraestrutura da Didit com um objetivo de 99,9% de tempo de atividade trimestral.
Casos de uso
- Fintech e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou estender crédito em França.
- Criptomoedas e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autoritária.
- Crédito — reduza a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
- Mercados e plataformas de gig — verifique utilizadores com dados autoritários, não apenas um formulário auto-declarado.
- iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores franceses com um registo auditável.
Como integrar com a Didit
Pode executar a Verificação Telefónica em França de duas maneiras:
- Apenas API direta. Este serviço é executado através da API, e não do construtor de fluxo de trabalho sem código.
- API direta. Chame o endpoint
/v3/database-validation/mostrado acima comservices=fra_phone. Leiamatch_typee o blocovalidationpor campo para impulsionar a sua lógica de aprovar / rever / rejeitar.
Cada conta Didit inclui 500 verificações gratuitas por mês, para que possa testar todo o fluxo de ponta a ponta antes de pagar por uma única consulta.
Perguntas frequentes
O que a Verificação Telefónica em França confirma?
Valida os dados submetidos com os dados da operadora de rede móvel e devolve um resultado de correspondência normalizado, para que saiba se a titularidade do número de telefone existe na fonte autoritária e quais os campos que corresponderam.
O que acontece se a fonte estiver temporariamente indisponível?
Não é cobrado. A faturação aplica-se apenas a resultados conclusivos — tempo de inatividade da fonte, campos em falta e rejeições pré-fonte são gratuitos.
Qual a rapidez da verificação?
A validação da base de dados normalmente retorna em alguns segundos, pelo que se encaixa num 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 sua primeira titularidade de número de telefone francês hoje.
- Leia a referência da API: Verificação Telefónica em França
- Veja todas as validações da base de dados: Preços e cobertura da Validação da Base de Dados
- Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, grátis.