API de Verificação de Buró de Crédito Alemão (PT-PT)

Integrar utilizadores na Alemanha significa confirmar que são quem afirmam ser. Verifica os dados de entrada com os dados do Cabeçalho de Crédito obtidos de um Buró de Crédito na Alemanha. Um documento ou um detalhe digitado apenas prova que os dados existem — não que são genuínos ou que pertencem à pessoa à sua frente. A Verificação de Buró de Crédito Alemão preenche essa lacuna verificando os dados com o ficheiro de identidade de um buró de crédito nacional. 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 Buró de Crédito Alemão valida a identidade do ficheiro de crédito contra o ficheiro de identidade de um buró de crédito nacional.
• O que obtém em retorno — 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.
• Por que é importante — Os dados de identidade do buró de crédito são extensos e bem mantidos, tornando-os uma fonte autoritária forte para confirmar que um candidato existe com a identidade e morada declaradas.
• Como usá-lo — um POST para o endpoint de validação de base de dados do Didit, ou um módulo de fluxo de trabalho sem código. $0.84 por consulta conclusiva, resultados em segundos.

O que a Verificação de Buró de Crédito Alemão valida

Verifica os dados de entrada com os dados do Cabeçalho de Crédito obtidos de um Buró de Crédito na Alemanha. O Didit expõe este serviço através de um único endpoint para que possa verificar os dados submetidos contra o ficheiro de identidade de um buró de crédito nacional 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 o source_data correspondente e um bloco validation por campo, para que o seu motor de risco obtenha um veredicto claro e legível por máquina.

Por que é importante

Os dados de identidade do buró de crédito são extensos e bem mantidos, tornando-os uma fonte autoritária forte para confirmar que um candidato existe com a identidade e morada declaradas.

Para empresas reguladas na Alemanha — 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 fotografia.

Detalhes técnicos

O 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 DEU.
services	string	Sim	Identificador de serviço. Use deu_credit_bureau.
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=DEU" \
  -F "services=deu_credit_bureau" \
  -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": "DEU",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "deu_credit_bureau",
      "service_name": "Germany Credit Bureau",
      "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",
        "postal_code": "10001",
        "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.84 por consulta conclusiva. É faturado apenas por resultados conclusivos — sem custos por inatividade da fonte, campos em falta ou rejeições pré-fonte.
• Fiabilidade: funciona na infraestrutura do Didit com um objetivo de 99.9% de tempo de atividade trimestral.
• Consentimento: este serviço requer consentimento documentado do utilizador final. Capture-o e armazene-o antes de chamar o endpoint.

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 Alemanha.
• Cripto e Web3 — cumpra os requisitos de integração VASP com uma prova de identidade de fonte autoritária.
• Empréstimos — reduza a identidade sintética e a fraude de primeira parte com dados verificados na fonte.
• Marketplaces e Plataformas Gig — verifique utilizadores contra dados autoritários, não apenas um formulário auto-reportado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores alemães com um registo auditável.

Como integrar com o Didit

Pode executar a Verificação de Buró de Crédito Alemão de duas formas:

1. Fluxo de trabalho sem código. Na Consola de Negócios Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Validação de Base de Dados, selecione Alemanha → Verificação de Buró de Crédito Alemão 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=deu_credit_bureau. 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 Buró de Crédito Alemão confirma?

Valida os dados submetidos contra o ficheiro de identidade de um buró de crédito nacional e retorna um resultado de correspondência normalizado, para que saiba se a identidade do ficheiro de crédito 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 — 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 tipicamente retorna em alguns segundos, por isso encaixa-se 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 a sua primeira identidade de ficheiro de crédito alemão hoje.

• Leia a referência da API: Verificação de Buró de Crédito Alemão
• 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.