Pular para o conteúdo principal
POST
Verifica os dados informados com base nos dados de Credit Header obtidos de um Credit Bureau no Canadá. Este serviço não fornece os dados exigidos pelo FINTRAC, mas pode fornecer indicadores adicionais de detecção de fraude. É necessário enviar uma solicitação à agência. A Didit disponibiliza este serviço por meio de POST /v3/database-validation/ para que você possa verificar os dados enviados com base na 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

Entradas

  • 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 workflow: 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 alfa-3 deste serviço de banco de dados.Exemplo: CAN
string
padrão:"can_credit_bureau_2_non_fintrac"
obrigatório
Array que contém este ID de serviço. Definir o serviço mantém a requisição restrita exatamente a este banco de dados.Exemplo: can_credit_bureau_2_non_fintrac
Consentimento explícito do usuário final para este serviço.Exemplo: true
string
padrão:"John"
obrigatório
Nome a ser validado.Exemplo: John
string
padrão:"Doe"
obrigatório
Sobrenome a ser validado.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 estruturado de endereço residencial. Use street_1, street_2, city, region, postal_code e country. Uma string de endereço completa no formato legado ainda é aceita, 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"
Sua referência estável de usuário para esta pessoa, como o seu ID interno de usuário. A Didit a usa para vincular verificações avulsas ao mesmo usuário final e reduzir o ruído na detecção de duplicatas.Exemplo: user-1234

Regras de entrada e observações de validação

  • Para serviços de endereço, envie campos de endereço estruturados em vez de uma única string address sempre que possível.
  • address.street_1 é o logradouro, incluindo o número e o tipo de via.
  • address.street_2 é o apartamento, unidade, edifício, andar ou linha adicional de endereço. Envie-o somente quando você o tiver.
  • address.city é a cidade, subúrbio, distrito, localidade ou bairro.
  • address.region é o estado, província, região ou município.
  • address.postal_code é o código postal ou CEP.
  • Os serviços de banco de dados baseados em endereço exigem pelo menos o logradouro e o código postal; requisições rejeitadas antes da consulta à fonte não são cobradas.

Como fazer a chamada

Dados retornados

Os campos exatos expostos em source_data dependem dos dados retornados pelo registro. O exemplo gerado para can_credit_bureau_2_non_fintrac documenta atualmente este formato normalizado:
  • address
  • date_of_birth
  • first_name
  • last_name

Preços e SLAs

As consultas ao Canada Credit Bureau 2 (Non-FINTRAC) são cobradas somente quando a Didit recebe um resultado conclusivo da fonte de validação.
  • Preço por chamada: $1.75 USD.
  • Faturamento: por consulta bem-sucedida. Você não é cobrado quando o registro está inacessível, quando faltam campos obrigatórios ou quando a requisição é rejeitada antes de chegar à fonte.
  • Latência: p95 típico < 2 s.
  • Disponibilidade: 99.9% por trimestre do lado da Didit; a disponibilidade da fonte externa varia por país e conjunto de dados.

Continue lendo

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