API de Verificação de Consumidores em Itália (PT-PT)

Integrar utilizadores em Itália significa confirmar que são quem afirmam ser. Valida dados de entrada numa base de dados de geração de leads. 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 Consumidores em Itália preenche essa lacuna, verificando os dados em relação a fontes de dados residenciais e de consumidores fidedignas. 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 Consumidores em Itália valida dados de endereço e residenciais em relação a fontes de dados residenciais e de consumidores fidedignas.
• O que obtém — um match_type normalizado, mais resultados ao nível do campo que pode encaminhar diretamente para a lógica de aprovar / rever / rejeitar.
• Porque é importante — A verificação de endereço em relação a dados fidedignos confirma que um candidato realmente vive onde afirma — um sinal central antifraude e de conformidade.
• Como usar — um POST para o endpoint de validação de base de dados da Didit, ou um módulo de fluxo de trabalho sem código. 0,08 $ por consulta conclusiva, resultados em segundos.

O que a Verificação de Consumidores em Itália valida

Valida dados de entrada numa base de dados de geração de leads. A Didit expõe-no através de um único endpoint para que possa verificar os dados submetidos em relação a fontes de dados residenciais e de consumidores fidedignas e receber um resultado estruturado e normalizado — não um despejo de registo bruto que tenha de analisar por si mesmo.

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

Porque é importante

A verificação de endereço em relação a dados fidedignos confirma que um candidato realmente vive onde afirma — um sinal central antifraude e de conformidade.

Para empresas reguladas em Itália — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — verificar contra uma fonte fidedigna 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 alfa-3. Use ITA.
services	string	Sim	Identificador de serviço. Use ita_consumer.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Último nome.
date_of_birth	string	Sim	Data de nascimento.
address	string	Não	Endereço (verificação cruzada opcional).
phone	string	Não	Telefone (verificação cruzada opcional).
email	string	Não	Email (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=ITA" \
  -F "services=ita_consumer" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ITA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "ita_consumer",
      "service_name": "Italy Consumer",
      "source_data": {
        "address": "123 Sample Street",
        "address_match_score": "1.000",
        "city": "Sample City",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "last_name": "Doe",
        "name_match_score": "1.000",
        "state": "Sample State",
        "street": "sample_value",
        "verifications": {
          "address": true,
          "date_of_birth": true,
          "full_name": true
        }
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: 0,08 $ por consulta conclusiva. Será faturado apenas pelos 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 trimestral de tempo de atividade de 99,9%.

Casos de uso

• Fintech e neobancos — confirmar um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito em Itália.
• Cripto e Web3 — cumprir os requisitos de integração VASP com prova de identidade de fonte fidedigna.
• Empréstimos — reduzir a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
• Mercados e plataformas gig — verificar utilizadores em relação a dados fidedignos, não apenas um formulário autorreportado.
• iGaming — satisfazer as verificações de identidade e elegibilidade para jogadores em Itália com um rasto auditável.

Como integrar com a Didit

Pode executar a Verificação de Consumidores em Itália de duas formas:

1. Fluxo de trabalho sem código. Na Consola de Negócios da Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Database Validation, selecione Italy → Italy Consumer Verification e ative-o. Os utilizadores correspondentes são encaminhados automaticamente — sem necessidade de engenharia.
2. API direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=ita_consumer. Leia match_type e o bloco de validation por campo para conduzir a sua lógica de aprovar / rever / rejeitar.

Todas as contas Didit incluem 500 verificações gratuitas por mês, para que possa testar o fluxo completo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação de Consumidores em Itália confirma?

Valida os dados submetidos em relação a fontes de dados residenciais e de consumidores fidedignas e retorna um resultado de correspondência normalizado, para que saiba se o endereço e os dados residenciais existem na fonte fidedigna e quais os campos que corresponderam.

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

Não será 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.

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

A validação da base de dados geralmente retorna em alguns segundos, por isso 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. Também pode integrá-lo num fluxo de trabalho sem código na Consola de Negócios.

Pronto para começar?

Valide o seu primeiro endereço e dados residenciais em Itália hoje.

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