API de Verificação de Cédula na Colômbia (PT-PT)

Integrar utilizadores na Colômbia significa confirmar que são quem afirmam ser. A Didit verifica os dados da Cédula de Cidadania colombiana através do seu fornecedor de verificação de identidade na Colômbia. 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 Cédula na Colômbia preenche essa lacuna, verificando os dados face ao registo oficial de identidade do governo do país. Este guia explica o que o controlo faz, os detalhes técnicos exatos e como integrá-lo em minutos.

Principais pontos:

• O que verifica — A Verificação de Cédula na Colômbia valida o número de identificação nacional face ao registo oficial de identidade do governo do país.
• O que obtém — um match_type normalizado, mais resultados por campo que pode encaminhar diretamente para a lógica de aprovar / rever / rejeitar.
• Porque é importante — Um documento pode ser forjado; um registo oficial não pode. Validar o número de identificação face à fonte governamental autoritativa confirma que o titular é real e está corretamente identificado.
• 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. $0.20 por consulta conclusiva, resultados em segundos.

O que a Verificação de Cédula na Colômbia valida

Verifica os dados da Cédula de Cidadania colombiana através do fornecedor de verificação de identidade da Didit na Colômbia. A Didit expõe este serviço através de um único endpoint para que possa verificar os dados submetidos face ao registo oficial de identidade do governo do país e receber um resultado estruturado e normalizado — não um despejo de registo bruto que tenha de analisar por si.

Uma resposta conclusiva devolve 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.

Porque é importante

Um documento pode ser forjado; um registo oficial não pode. Validar o número de identificação face à fonte governamental autoritativa confirma que o titular é real e está corretamente identificado.

Para empresas reguladas na Colômbia — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — a verificação face a 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 fotografia.

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 COL.
services	string	Sim	Identificador de serviço. Use col_cedula.
personal_number	string	Sim	Número pessoal.
first_name	string	Não	Nome próprio (verificação cruzada opcional).
last_name	string	Não	Último nome (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=COL" \
  -F "services=col_cedula" \
  -F "personal_number=1111111"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "COL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "col_cedula",
      "service_name": "Colombia - Cédula verification",
      "source_data": {
        "document_type": "sample_value",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: $0.20 por consulta conclusiva. É faturado apenas por resultados conclusivos — sem custos por tempo de inatividade da fonte, campos em falta ou rejeições pré-fonte.
• Confiabilidade: 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 na Colômbia.
• Cripto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autoritativa.
• Empréstimos — reduza a fraude de identidade sintética e de primeira parte com dados verificados na fonte.
• Mercados e plataformas gig — verifique utilizadores face a dados autoritativos, não apenas um formulário autorreferido.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores da Colômbia com um rasto auditável.

Como integrar com a Didit

Pode executar a Verificação de Cédula na Colômbia de duas maneiras:

1. Fluxo de trabalho sem código. Na Consola de Negócios da Didit, abra o Construtor de Fluxos de Trabalho, adicione o módulo Validação de Base de Dados, selecione Colômbia → Verificação de Cédula na Colômbia 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=col_cedula. Leia match_type e o bloco de validation por campo para conduzir 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 Cédula na Colômbia confirma?

Valida os dados submetidos face ao registo oficial de identidade do governo do país e devolve um resultado de correspondência normalizado, para que saiba se o número de identificação nacional 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ápido é o controlo?

A validação da base de dados normalmente retorna em alguns segundos, por isso encaixa num fluxo de integração em tempo real.

Preciso de um SDK?

Não. O controlo é um único POST HTTPS para um endpoint. Também pode integrá-lo num fluxo de trabalho sem código na Consola de Negócios.

Pronto para começar?

Valide o seu primeiro número de identificação nacional da Colômbia hoje.

• Leia a referência da API: Verificação de Cédula na Colômbia
• Consulte todas as validações de base de dados: Preços e cobertura de Validação de Base de Dados
• Comece a construir: Crie uma conta Didit gratuita — 500 verificações por mês, grátis.