Saltar para o conteúdo principal
POST
Verifica os dados submetidos face aos dados de cabeçalho de crédito obtidos de uma agência de crédito no Canadá. Este serviço não fornece os dados exigidos pela FINTRAC, mas pode fornecer indicadores adicionais de deteção de fraude. É necessária uma aplicação para agências. A Didit disponibiliza este serviço através de POST /v3/database-validation/, para que possa verificar os dados submetidos face à fonte oficial e receber resultados de correspondência normalizados.

Cobertura

  • Cobertura: ~ 85%
  • País: Canadá
  • ID do serviço: can_credit_bureau_2_non_fintrac
  • Domínio de dados: Financeiro
  • Categoria: CreditBureau

Dados de entrada

  • Entradas obrigatórias: first_name, last_name, date_of_birth, address.street_1, address.postal_code
  • Entradas opcionais: address.street_2, address.city, address.region, vendor_data
  • Consentimento: Obrigatório
  • Disponibilidade no fluxo: Disponível no fluxo
  • Cobertura: ~ 85%
  • Preço: $1.75 por consulta bem-sucedida

Parâmetros do corpo

string
padrão:"CAN"
obrigatório
Código de país ISO 3166-1 alpha-3 para este serviço de base de dados.Exemplo: CAN
string
padrão:"can_credit_bureau_2_non_fintrac"
obrigatório
Array que contém este ID de serviço. Fixar o serviço mantém o pedido restrito a esta base de dados exata.Exemplo: can_credit_bureau_2_non_fintrac
Consentimento explícito do utilizador final para este serviço.Exemplo: true
string
padrão:"John"
obrigatório
Nome próprio a validar.Exemplo: John
string
padrão:"Doe"
obrigatório
Apelido a validar.Exemplo: Doe
string
padrão:"1990-01-01"
obrigatório
Data de nascimento no formato YYYY-MM-DD.Exemplo: 1990-01-01
object
obrigatório
Objeto de morada residencial estruturado. Use street_1, street_2, city, region, postal_code e country. Uma cadeia de texto de morada no formato antigo continua a ser aceite, mas não é recomendada.Exemplo: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
padrão:"user-1234"
A sua referência de utilizador estável para esta pessoa, como o seu ID interno de utilizador. A Didit usa-a para ligar verificações independentes ao mesmo utilizador final e reduzir o ruído de deteção de duplicados.Exemplo: user-1234

Regras de entrada e notas de validação

  • Nos serviços baseados em morada, envie campos de morada estruturados em vez de uma única cadeia address sempre que possível.
  • address.street_1 é a morada, incluindo o número de polícia e o tipo de via.
  • address.street_2 é o apartamento, fração, edifício, piso ou outra linha adicional da morada. Envie-o apenas quando o tiver.
  • address.city é a cidade, subúrbio, distrito, localidade ou bairro.
  • address.region é o estado, província, região ou localidade.
  • address.postal_code é o código postal.
  • Os serviços de base de dados baseados em morada exigem, no mínimo, a morada da rua e o código postal. Os pedidos rejeitados antes da consulta à fonte não são cobrados.

Como fazer a chamada

Dados devolvidos

Os campos exatos apresentados em source_data dependem do que o registo devolve. O exemplo gerado para can_credit_bureau_2_non_fintrac documenta atualmente esta estrutura normalizada:
  • address
  • date_of_birth
  • first_name
  • last_name

Preços e SLAs

As consultas Canada Credit Bureau 2 (Non-FINTRAC) são faturadas apenas quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $1.75 USD.
  • Faturação: por consulta bem-sucedida. Não é cobrado quando o registo não está acessível, quando faltam campos obrigatórios ou quando o pedido é rejeitado antes de chegar à fonte.
  • Latência: p95 típico < 2 s.
  • Disponibilidade: 99.9% por trimestre do lado da Didit; a disponibilidade das fontes a jusante varia consoante o país e o conjunto de dados.

Continue a ler

Última modificação em 7 de novembro de 2026