API de Verificação de Buró de Crédito dos EUA (PT-PT-1)

Integrar utilizadores nos Estados Unidos significa confirmar que são quem dizem ser. Serviço agregado de dados de cabeçalho de crédito e outros serviços. 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 Buró de Crédito dos Estados Unidos preenche essa lacuna, verificando os dados contra 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 dos Estados Unidos valida a identidade do ficheiro de crédito contra o ficheiro de identidade de um buró de crédito nacional.
• O que recebe em troca — um match_type normalizado mais resultados a nível de campo que pode direcionar diretamente para a lógica de aprovar / rever / rejeitar.
• Porquê é importante — Os dados de identidade do buró de crédito são extensos e bem mantidos, tornando-os uma fonte autoritativa forte para confirmar que um requerente existe com a identidade e endereço declarados.
• 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,11€ por consulta conclusiva, resultados em segundos.

O que a Verificação de Buró de Crédito dos Estados Unidos valida

Serviço agregado de dados de cabeçalho de crédito e outros serviços. A Didit expõe-no 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 tem de analisar você 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.

Porquê é importante

Os dados de identidade do buró de crédito são extensos e bem mantidos, tornando-os uma fonte autoritativa forte para confirmar que um requerente existe com a identidade e endereço declarados.

Para empresas reguladas nos Estados Unidos — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — verificar contra uma fonte autoritativa 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 USA.
services	string	Sim	Identificador de serviço. Use usa_states_credit_bureau.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Último nome.
date_of_birth	string	Não	Data de nascimento (verificação cruzada opcional).
address	string	Não	Morada (verificação cruzada opcional).
phone	string	Não	Telefone (verificação cruzada opcional).
ssn	string	Não	SSN (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=USA" \
  -F "services=usa_states_credit_bureau" \
  -F "first_name=John" \
  -F "last_name=Doe"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "USA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "usa_states_credit_bureau",
      "service_name": "United States of America - United States 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",
        "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,11€ por consulta conclusiva. É 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 de tempo de atividade trimestral de 99,9%.

Casos de uso

• Fintech e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito nos Estados Unidos.
• Cripto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autoritativa.
• Empréstimos — reduza a identidade sintética e a fraude de primeira parte com dados verificados na fonte.
• Mercados e plataformas de trabalho temporário — verifique utilizadores contra dados autoritativos, não apenas um formulário auto-reportado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores dos Estados Unidos com um rasto auditável.

Como integrar com a Didit

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

1. Fluxo de trabalho sem código. Na Consola Empresarial Didit, abra o Construtor de Fluxo de Trabalho, adicione o módulo Validação de Base de Dados, selecione Estados Unidos → Verificação de Buró de Crédito dos Estados Unidos 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=usa_states_credit_bureau. Leia match_type e o bloco validation por 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 o fluxo completo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação de Buró de Crédito dos Estados Unidos 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 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 retorna tipicamente 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á-la num fluxo de trabalho sem código na Consola Empresarial.

Pronto para começar?

Valide hoje a sua primeira identidade de ficheiro de crédito dos Estados Unidos.

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