API de Verificação de Consumidores no Canadá (PT-BR)

Integrar usuários no Canadá significa confirmar que eles são quem dizem ser. Verifica dados inseridos em um banco de dados de geração de leads. Um documento ou um dado digitado apenas prova que a informação existe — não que seja genuína ou pertença à pessoa em frente a você. A Verificação de Consumidores no Canadá preenche essa lacuna, verificando os dados em fontes autorizadas de dados residenciais e de consumidores. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais conclusões:

• O que é verificado — A Verificação de Consumidores no Canadá valida endereços e dados residenciais em fontes de dados autorizadas.
• 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 aprovar / revisar / rejeitar.
• Por que isso importa — A verificação de endereço em fontes autorizadas confirma se um solicitante realmente mora onde afirma — um sinal central de prevenção de fraudes e conformidade.
• Como usá-lo — 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. $0,05 por consulta conclusiva, resultados em segundos.

O que a Verificação de Consumidores no Canadá valida

Verifica dados inseridos em um banco de dados de geração de leads. A Didit os disponibiliza por meio de um único endpoint para que você possa validar os dados enviados em fontes autorizadas de dados residenciais e de consumidores e receber um resultado estruturado e normalizado — não um despejo bruto de registro que você precise analisar.

Uma resposta conclusiva retorna os source_data correspondentes 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 isso importa

A verificação de endereço em fontes autorizadas confirma se um solicitante realmente mora onde afirma — um sinal central de prevenção de fraudes e conformidade.

Para empresas regulamentadas no Canadá — fintechs, plataformas de criptomoedas, credores, marketplaces e operadores de jogos — a verificação em uma fonte autorizada produz um registro defendível e auditável de que a identidade foi confirmada na fonte, e não apenas capturada de um formulário ou foto.

Detalhes técnicos

A Didit disponibiliza este serviço por meio do endpoint unificado de validação de banco de dados. É um único POST — sem SDK necessário.

Endpoint

POST /v3/database-validation/

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código de país ISO 3166-1 alpha-3. Use CAN.
services	string	Sim	Identificador do serviço. Use can_consumer.
first_name	string	Sim	Nome.
last_name	string	Sim	Sobrenome.
date_of_birth	string	Sim	Data de nascimento.
address	string	Não	Endereço (verificação cruzada opcional).
phone	string	Não	Telefone (verificação cruzada opcional).
email	string	Não	E-mail (verificação cruzada opcional).

Exemplo de solicitação

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: SUA_CHAVE_API" \
  -F "issuing_state=CAN" \
  -F "services=can_consumer" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "CAN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "can_consumer",
      "service_name": "Canada Consumer",
      "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"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e cobrança

• Latência: normalmente alguns segundos.
• Custo: $0,05 por consulta conclusiva. Você é cobrado apenas por resultados conclusivos — sem cobrança por inatividade da fonte, campos ausentes ou rejeições pré-fonte.
• Confiabilidade: executa na infraestrutura da Didit com uma meta de tempo de atividade trimestral de 99,9%.

Casos de uso

• Fintechs e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou conceder crédito no Canadá.
• Cripto e Web3 — atenda aos requisitos de integração de VASP com prova de identidade de fonte autorizada.
• Empréstimos — reduza fraudes de identidade sintética e de primeira parte com dados verificados na fonte.
• Marketplaces e plataformas de trabalho freelancer — verifique os usuários em fontes autorizadas, e não apenas em um formulário auto-relatado.
• iGaming — atenda aos requisitos de identidade e elegibilidade para jogadores no Canadá com um registro auditável.

Como integrar com a Didit

Você pode executar a Verificação de Consumidores no Canadá de duas maneiras:

1. Fluxo de trabalho sem código. No Console de Negócios da Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Validação de Banco de Dados, selecione Canadá → Verificação de Consumidores no Canadá e ative-o. Os usuários correspondentes são roteados automaticamente — sem necessidade de engenharia.
2. API direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=can_consumer. Leia match_type e o bloco de validation por campo para direcionar sua lógica de aprovar / revisar / rejeitar.

Cada conta Didit inclui 500 verificações gratuitas por mês, para que você possa testar todo o fluxo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação de Consumidores no Canadá confirma?

Ela valida os dados enviados em fontes autorizadas de dados residenciais e de consumidores e retorna um resultado de correspondência normalizado, para que você saiba se o endereço e os dados residenciais existem na fonte autorizada e quais campos corresponderam.

O que acontece se a fonte estiver temporariamente indisponível?

Você não será cobrado. A cobrança se aplica apenas a resultados conclusivos — inatividade da fonte, campos ausentes e rejeições pré-fonte são gratuitas.

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

A validação do banco de dados normalmente retorna em alguns segundos, para que se encaixe em um fluxo de integração em tempo real.

Eu preciso de um SDK?

Não. A verificação é um único POST HTTPS para um endpoint. Você também pode conectá-lo a um fluxo de trabalho sem código no Console de Negócios.

Pronto para começar?

Valide seu primeiro endereço e dados residenciais no Canadá hoje.

• Leia a referência da API: Verificação de Consumidores no Canadá
• Veja todas as validações de banco de dados: Preços e cobertura da Validação de Banco de Dados
• Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, grátis.