API de Verificação Residencial no Chile (PT-PT-1)

Integrar utilizadores no Chile significa confirmar que são quem afirmam ser. A verificação compara os dados de entrada com uma base de dados de uma agência governamental que contém dados de identidade nacional dos cidadã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 Residencial no Chile preenche essa lacuna, verificando os dados contra 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.

Pontos-chave:

• O que verifica — A Verificação Residencial no Chile valida dados de morada e residenciais contra fontes autorizadas de dados residenciais e de consumidores.
• O que recebe — um match_type normalizado, mais resultados ao nível do campo que pode encaminhar diretamente para a lógica de aprovar / rever / rejeitar.
• Porquê é importante — A verificação de morada contra dados autorizados confirma que um candidato realmente vive onde afirma — um sinal central antifraude e de conformidade.
• Como usar — 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. 1,42 € por consulta conclusiva, resultados em segundos.

O que a Verificação Residencial no Chile valida

Verifica os dados de entrada contra uma base de dados de uma agência governamental que contém dados de identidade nacional dos cidadãos. A Didit expõe isto através de um único endpoint para que possa verificar os dados submetidos contra fontes autorizadas de dados residenciais e de consumidores e receber um resultado estruturado e normalizado — não um despejo de registo bruto que tenha de analisar por si 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

A verificação de morada contra dados autorizados confirma que um candidato realmente vive onde afirma — um sinal central antifraude e de conformidade.

Para empresas reguladas no Chile — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — a verificação contra uma fonte autorizada produz um registo defensável e auditável de que a identidade foi confirmada na fonte, e não meramente 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 do pedido

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código do país ISO 3166-1 alfa-3. Use CHL.
services	string	Sim	Identificador do serviço. Use chl_residential.
first_name	string	Sim	Primeiro nome.
last_name	string	Sim	Último nome.
address	string	Sim	Morada.

Exemplo de pedido

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=CHL" \
  -F "services=chl_residential" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "address=123 Sample Street, Sample City, 10001"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "CHL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "chl_residential",
      "service_name": "Chile Residential",
      "source_data": {
        "address": "123 Sample Street",
        "first_name": "John",
        "last_name": "Doe"
      },
      "validation": {
        "address": "full_match",
        "full_name": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: 1,42 € por consulta conclusiva. É faturado apenas sobre resultados conclusivos — sem custos 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 estender crédito no Chile.
• Criptomoedas e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autorizada.
• Empréstimos — reduza a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
• Mercados e plataformas de gig — verifique utilizadores contra dados autorizados, não apenas um formulário autorrelatado.
• iGaming — satisfaça verificações de identidade e elegibilidade para jogadores chilenos com um registo auditável.

Como integrar com a Didit

Pode executar a Verificação Residencial no Chile de duas maneiras:

1. Fluxo de trabalho sem código. Na Consola Empresarial da Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Validação de Base de Dados, selecione Chile → Verificação Residencial no Chile 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=chl_residential. Leia match_type e o bloco de 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 confirma a Verificação Residencial no Chile?

Valida os dados submetidos contra fontes autorizadas de dados residenciais e de consumidores e retorna um resultado de correspondência normalizado, para que saiba se a morada e os dados residenciais existem na fonte autorizada 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 normalmente retorna 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 conectá-lo a um fluxo de trabalho sem código na Consola Empresarial.

Pronto para começar?

Valide a sua primeira morada e dados residenciais no Chile hoje.

• Leia a referência da API: Verificação Residencial no Chile
• 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.