API de Verificação de Crédito na Alemanha (PT-BR)

Integrar usuários na Alemanha significa confirmar que eles são quem afirmam ser. Verifique os dados de entrada contra os dados do cabeçalho de crédito obtidos de um Birô 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 pertencem à pessoa à sua frente. A Verificação de Crédito na Alemanha preenche essa lacuna verificando os dados contra o arquivo de identidade de um birô 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 Crédito na Alemanha valida a identidade do arquivo de crédito contra o arquivo de identidade de um birô de crédito nacional.
• 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 — Os dados de identidade do birô de crédito são profundos e bem mantidos, tornando-os uma forte fonte autoritária para confirmar que um solicitante existe na identidade e endereço declarados.
• Como usar — um POST para o endpoint de validação de banco de dados da Didit, ou um módulo de fluxo de trabalho sem código. US$0,84 por consulta conclusiva, resultados em segundos.

O que a Verificação de Crédito na Alemanha valida

Verifica os dados de entrada contra os dados do cabeçalho de crédito obtidos de um Birô de Crédito na Alemanha. A Didit o expõe através de um único endpoint para que você possa verificar os dados enviados contra o arquivo de identidade de um birô de crédito nacional e receber um resultado estruturado e normalizado — não um despejo de registro bruto que você precisa analisar por conta própria.

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

Por que é importante

Os dados de identidade do birô de crédito são profundos e bem mantidos, tornando-os uma forte fonte autoritária para confirmar que um solicitante existe na identidade e endereço declarados.

Para empresas regulamentadas na Alemanha — fintechs, plataformas de criptomoedas, 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, e não apenas capturada de um formulário ou 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 da requisição

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código do país ISO 3166-1 alfa-3. Use DEU.
services	string	Sim	Identificador do serviço. Use deu_credit_bureau.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Sobrenome.
date_of_birth	string	Sim	Data de nascimento.
address	string	Sim	Endereço.

Exemplo de requisição

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 cobrança

• Latência: geralmente alguns segundos.
• Custo: US$0,84 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: funciona na infraestrutura da Didit com uma meta de tempo de atividade trimestral de 99,9%.
• Consentimento: este serviço requer consentimento documentado do usuário final. Capture 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 prova de identidade de fonte autoritativa.
• Empréstimos — reduza fraudes de identidade sintética e de primeira parte com dados verificados na fonte.
• Marketplaces e plataformas de gig — verifique usuários contra dados autoritativos, não apenas um formulário auto-declarado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores na Alemanha com um rastro auditável.

Como integrar com a Didit

Você pode executar a Verificação de Crédito na Alemanha de duas maneiras:

1. Fluxo de trabalho sem código. No Didit Business Console, abra o Construtor de Fluxo de Trabalho, adicione o módulo Validação de Banco de Dados, selecione Alemanha → Verificação de Crédito na Alemanha e ative-o. Usuários correspondentes são roteados 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 acionar sua lógica de aprovação / revisão / rejeição.

Cada 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 Crédito na Alemanha confirma?

Ela valida os dados enviados contra o arquivo de identidade de um birô de crédito nacional e retorna um resultado de correspondência normalizado, para que você saiba se a identidade do arquivo de crédito 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.

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

A validação de banco de dados geralmente retorna em alguns segundos, então ela 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. Você também pode conectá-la a um fluxo de trabalho sem código no Business Console.

Pronto para começar?

Valide sua primeira identidade de arquivo de crédito na Alemanha hoje.

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