API de Verificação de Identidade Residencial na Indonésia (PT-BR)

Integrar usuários na Indonésia significa confirmar que eles são quem afirmam 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 pertencem à pessoa à sua frente. A Verificação de Cartão de Identidade Residencial da Indonésia preenche essa lacuna verificando os dados contra fontes autoritativas 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 pontos:

• O que verifica — A Verificação de Cartão de Identidade Residencial da Indonésia valida o endereço e os dados residenciais contra fontes autoritativas de dados residenciais e de consumidores.
• 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 é importante — A verificação de endereço contra dados autoritativos confirma que um solicitante realmente mora onde afirma — um sinal central antifraude e de 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. US$0,16 por consulta conclusiva, resultados em segundos.

O que a Verificação de Cartão de Identidade Residencial da Indonésia valida

Verifica os dados de entrada contra uma agência governamental. A Didit o expõe através de um único endpoint para que você possa verificar os dados enviados contra fontes autoritativas de dados residenciais e de consumidores e receber um resultado estruturado e normalizado — não um despejo de registro bruto que você precisa analisar por conta própria.

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

Por que é importante

A verificação de endereço contra dados autoritativos confirma que um solicitante realmente mora onde afirma — um sinal central antifraude e de conformidade.

Para empresas regulamentadas na Indonésia — fintechs, plataformas de cripto, credores, mercados 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 do país ISO 3166-1 alfa-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	Endereço.
address	string	Não	Endereço (verificação cruzada opcional).
gender	string	Não	Gênero (verificação cruzada 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=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 faturamento

• Latência: tipicamente alguns segundos.
• Custo: US$0,16 por consulta conclusiva. Você é cobrado apenas por resultados conclusivos — sem custo por tempo de inatividade da fonte, campos ausentes ou rejeições pré-fonte.
• Confiabilidade: funciona na infraestrutura da Didit com uma meta trimestral de 99,9% de tempo de atividade.
• Consentimento: este serviço requer consentimento documentado do usuário final. Capture e armazene-o antes de chamar o endpoint.

Casos de uso

• Fintechs e neobancos — confirme um titular de conta real e verificável antes de abrir uma carteira ou estender crédito na Indonésia.
• 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.
• Marketplaces e plataformas de gig — verifique usuários contra dados autoritativos, não apenas um formulário auto-relatado.
• iGaming — satisfaça verificações de identidade e elegibilidade para jogadores da Indonésia com um rastro auditável.

Como integrar com a Didit

Você pode executar a Verificação de Cartão de Identidade Residencial da Indonésia 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 Indonesia → Indonesia Residential Identity Card 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=idn_residential_identity_card. Leia match_type e o bloco validation por campo para conduzir sua lógica de aprovar / revisar / rejeitar.

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

Perguntas frequentes

O que a Verificação de Cartão de Identidade Residencial da Indonésia confirma?

Ela valida os dados enviados contra fontes autoritativas 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 autoritativa e quais campos corresponderam.

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

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

Qual a velocidade da verificação?

A validação do banco de dados geralmente retorna em alguns segundos, então ela 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 endereço e dados residenciais da Indonésia hoje mesmo.

• Leia a referência da API: Verificação de Cartão de Identidade Residencial da Indonésia
• 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.