API de Verificação de Cidadãos do Reino Unido (PT-PT)

Integrar utilizadores no Reino Unido significa confirmar que são quem afirmam ser. Verifica os dados contra os dados do recenseamento eleitoral obtidos de agências governamentais. 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 Cidadãos do Reino Unido preenche essa lacuna, verificando os dados contra o registo de cidadania/civil oficial. 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 Cidadãos do Reino Unido valida o registo de cidadania contra o registo de cidadania/civil oficial.
• O que obtém em troca — um match_type normalizado, mais resultados ao nível do campo que pode encaminhar diretamente para a lógica de aprovação/revisão/rejeição.
• Porque é importante — Confirmar o estado de cidadania contra o registo de origem impede a fabricação de identidade e apoia verificações de residência, benefícios e integração regulamentada.
• Como usá-lo — 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.75 por consulta conclusiva, resultados em segundos.

O que a Verificação de Cidadãos do Reino Unido valida

Verifica os dados contra os dados do recenseamento eleitoral obtidos de agências governamentais. A Didit expõe-no através de um único endpoint para que possa verificar os dados submetidos contra o registo de cidadania/civil oficial e receber um resultado estruturado e normalizado — não um despejo bruto do registo que tenha de analisar por si mesmo.

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

Porque é importante

Confirmar o estado de cidadania contra o registo de origem impede a fabricação de identidade e apoia verificações de residência, benefícios e integração regulamentada.

Para empresas reguladas no Reino Unido — fintechs, plataformas de cripto, credores, mercados e operadores de jogos — a verificação contra uma fonte autoritativa produz um registo defensável e auditável de que a identidade foi confirmada na origem, e não meramente capturada de um formulário ou de uma fotografia.

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 GBR.
services	string	Sim	Identificador de serviço. Use gbr_kingdom_citizens.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Último nome.
date_of_birth	string	Sim	Data de nascimento.
address	string	Sim	Morada.

Exemplo de pedido

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=GBR" \
  -F "services=gbr_kingdom_citizens" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "address=123 Sample Street, Sample City, 10001"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "GBR",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "gbr_kingdom_citizens",
      "service_name": "United Kingdom Citizens",
      "source_data": {
        "address": "123 Sample Street",
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: $0.75 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 trimestral de 99,9% de tempo de atividade.

Casos de uso

• Fintech e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito no Reino Unido.
• 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 origem.
• Mercados e plataformas de trabalho temporário — verifique os utilizadores contra dados autoritativos, não apenas um formulário autorrelatado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores do Reino Unido com um rasto auditável.

Como integrar com a Didit

Pode executar a Verificação de Cidadãos do Reino Unido de duas maneiras:

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 Validação de Base de Dados, selecione Reino Unido → Verificação de Cidadãos do Reino Unido 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=gbr_kingdom_citizens. Leia match_type e o bloco validation por campo para impulsionar a sua lógica de aprovação/revisão/rejeição.

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 de Cidadãos do Reino Unido confirma?

Valida os dados submetidos contra o registo de cidadania/civil oficial e devolve um resultado de correspondência normalizado, para que saiba se o registo de cidadania existe na fonte autoritativa 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.

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

A validação da base de dados normalmente 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 registo de cidadania do Reino Unido hoje.

• Leia a referência da API: Verificação de Cidadãos do Reino Unido
• Veja todas as validações de base de dados: Preços e cobertura de Validação de Base de Dados
• Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, gratuitas.