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

Integrar usuários na Colômbia significa confirmar que eles são quem dizem ser. A Didit verifica os dados da Cédula de Ciudadanía colombiana através de seu provedor de verificação de identidade na Colômbia. Um documento ou um detalhe digitado apenas prova que os dados existem — não que sejam genuínos ou pertençam à pessoa à sua frente. A Verificação de Cédula da Colômbia preenche essa lacuna verificando os dados contra o registro oficial de identidade do governo do país. Este guia explica o que a verificação faz, os detalhes técnicos exatos e como integrá-la em minutos.

Principais pontos:

• O que verifica — A Verificação de Cédula da Colômbia valida o RG nacional contra o registro oficial de identidade do governo do país.
• 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 aprovação / revisão / rejeição.
• Por que é importante — Um documento pode ser falsificado; um registro não. Validar o RG contra a fonte governamental autoritativa confirma que o titular é real e corretamente identificado.
• Como usar — 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. US$0,20 por consulta conclusiva, resultados em segundos.

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

Verifica os dados da Cédula de Ciudadanía colombiana através do provedor de verificação de identidade da Colômbia da Didit. A Didit o expõe através de um único endpoint para que você possa verificar os dados enviados contra o registro oficial de identidade do governo do país e receber um resultado estruturado e normalizado — não um despejo bruto do registro que você precisa analisar por conta própria.

Uma resposta conclusiva retorna o source_data correspondente e um bloco de validation por campo, para que seu motor de risco obtenha um veredito claro e legível por máquina.

Por que é importante

Um documento pode ser falsificado; um registro não. Validar o RG contra a fonte governamental autoritativa confirma que o titular é real e corretamente identificado.

Para empresas reguladas na Colômbia — fintechs, plataformas de cripto, credores, marketplaces e operadores de jogos — a verificação contra uma fonte autoritativa produz um registro defensá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 expõe este serviço através do endpoint unificado de validação de banco de dados. É um único POST — nenhum 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 COL.
services	string	Sim	Identificador de serviço. Use col_cedula.
personal_number	string	Sim	Número pessoal.
first_name	string	Não	Primeiro nome (verificação opcional).
last_name	string	Não	Sobrenome (verificação opcional).

Exemplo de solicitação

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 faturamento

• Latência: tipicamente alguns segundos.
• Custo: US$0,20 por consulta conclusiva. Você é cobrado apenas por resultados conclusivos — sem cobrança por tempo de inatividade da fonte, campos ausentes ou rejeições pré-fonte.
• Confiabilidade: funciona na infraestrutura da Didit com uma meta 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 na Colômbia.
• Cripto e Web3 — atenda aos 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.
• Marketplaces e plataformas de gig — verifique usuários contra dados autoritativos, não apenas um formulário autodeclarado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores da Colômbia com um rastro auditável.

Como integrar com a Didit

Você pode executar a Verificação de Cédula da Colômbia de duas maneiras:

1. Fluxo de trabalho sem código. No Didit Business Console, abra o Workflow Builder, adicione o módulo Database Validation, selecione Colombia → Colombia Cédula Verification 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=col_cedula. Leia match_type e o bloco validation por campo para acionar sua lógica de aprovação / revisão / rejeição.

Toda 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 Cédula da Colômbia confirma?

Ela valida os dados enviados contra o registro oficial de identidade do governo do país e retorna um resultado de correspondência normalizado, para que você saiba se o RG nacional existe na fonte autoritativa e quais campos corresponderam.

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

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

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

A validação de banco de dados geralmente retorna em alguns segundos, então se encaixa em um fluxo de integração em tempo real.

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 Business Console.

Pronto para começar?

Valide seu primeiro RG nacional da Colômbia hoje.

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