API de Verificação de Cartão de Cidadão Indonésio (PT-PT)

Integrar utilizadores na Indonésia significa confirmar que são quem dizem ser. Verifica os dados de entrada contra uma agência governamental. Um documento ou um detalhe digitado apenas prova que os dados existem — não que são genuínos ou que pertencem à pessoa à sua frente. A Verificação do Cartão de Cidadão Indonésio preenche essa lacuna, verificando os dados contra fontes de dados residenciais e de consumidores autorizadas. 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 do Cartão de Cidadão Indonésio valida dados de morada e residência contra fontes de dados residenciais e de consumidores autorizadas.
• O que recebe — um match_type normalizado, mais resultados ao nível do campo que pode encaminhar diretamente para a lógica de aprovação / revisão / rejeição.
• Por que é importante — A verificação de morada contra dados autorizados confirma que um requerente realmente vive onde afirma — um sinal central de anti-fraude e conformidade.
• Como usá-lo — 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.16 por consulta conclusiva, resultados em segundos.

O que a Verificação do Cartão de Cidadão Indonésio valida

Verifica os dados de entrada contra uma agência governamental. A Didit expõe este serviço através de um único endpoint para que possa verificar os dados submetidos contra fontes de dados residenciais e de consumidores autorizadas e receber um resultado estruturado e normalizado — não um despejo de registo bruto que tenha de analisar você 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.

Por que é importante

A verificação de morada contra dados autorizados confirma que um requerente realmente vive onde afirma — um sinal central de anti-fraude e conformidade.

Para empresas reguladas na Indonésia — 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 origem, não apenas 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 — sem necessidade de SDK.

Endpoint

POST /v3/database-validation/

Parâmetros de pedido

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código do país ISO 3166-1 alpha-3. Use IDN.
services	string	Sim	Identificador de serviço. Use idn_residential_identity_card.
full_name	string	Sim	Nome completo.
date_of_birth	string	Sim	Data de nascimento.
national_id	string	Sim	ID nacional.
address	string	Sim	Morada.
address	string	Não	Morada (verificação cruzada opcional).
gender	string	Não	Género (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=IDN" \
  -F "services=idn_residential_identity_card" \
  -F "full_name=John Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111" \
  -F "address=123 Sample Street, Sample City, 10001"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "IDN",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "idn_residential_identity_card",
      "service_name": "Indonesia Residential Identity Card",
      "source_data": {
        "address": "123 Sample Street",
        "address_match_score": "1.000",
        "city": "Sample City",
        "date_of_birth": "1990-01-01",
        "identification_number": "SAMPLE-ID-12345",
        "postal_code": "10001",
        "state": "Sample State",
        "street": "sample_value"
      },
      "validation": {
        "address": "full_match",
        "date_of_birth": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: $0.16 por consulta conclusiva. É faturado apenas em resultados conclusivos — sem custo por tempo de inatividade da fonte, campos em falta ou rejeições pré-fonte.
• Fiabilidade: executa na infraestrutura da Didit com um objetivo de 99.9% de tempo de atividade trimestral.
• Consentimento: este serviço requer consentimento documentado do utilizador final. Capture e armazene-o antes de chamar o endpoint.

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 Indonésia.
• Cripto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autorizada.
• Crédito — reduza a fraude de identidade sintética e de primeira parte com dados verificados na origem.
• Mercados e plataformas de gig — verifique utilizadores contra dados autorizados, não apenas um formulário auto-reportado.
• iGaming — satisfaça verificações de identidade e elegibilidade para jogadores da Indonésia com um registo auditável.

Como integrar com a Didit

Pode executar a Verificação do Cartão de Cidadão Indonésio de duas formas:

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 Indonésia → Verificação do Cartão de Cidadão Indonésio 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=idn_residential_identity_card. Leia match_type e o bloco validation por campo para impulsionar a sua lógica de aprovação / revisão / rejeição.

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 do Cartão de Cidadão Indonésio confirma?

Valida os dados submetidos contra fontes de dados residenciais e de consumidores autorizadas 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 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 ligá-la a um fluxo de trabalho sem código na Consola de Negócios.

Pronto para começar?

Valide a sua primeira morada e dados residenciais da Indonésia hoje.

• Leia a referência da API: Verificação do Cartão de Cidadão Indonésio
• 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, gratuitas.