API de Verificação de Identidade Nacional da Malásia (PT-PT)

A integração de utilizadores na Malásia implica confirmar a sua identidade. Verifica os dados inseridos contra uma base de dados de agências governamentais composta por dados de cidadãos malaios. 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 Identidade Nacional da Malásia preenche essa lacuna verificando os dados contra o registo 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 Identidade Nacional da Malásia valida a identidade nacional contra o registo oficial de identidade do governo do país.
• O que obtém — 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 — Um documento pode ser falsificado; um registo não. A validação da identidade contra a fonte governamental autoritária 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,16 € por consulta conclusiva, resultados em segundos.

O que a Verificação de Identidade Nacional da Malásia valida

Verifica os dados inseridos contra uma base de dados de agências governamentais composta por dados de cidadãos malaios. A Didit expõe-no através de um único endpoint para que possa verificar os dados submetidos contra o 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 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.

Porquê é importante

Um documento pode ser falsificado; um registo não. A validação da identidade contra a fonte governamental autoritária confirma que o titular é real e está corretamente identificado.

Para empresas reguladas na Malásia — fintechs, plataformas de criptomoedas, credores, mercados e operadores de jogos — a verificação contra uma fonte autoritária 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 alpha-3. Use MYS.
services	string	Sim	Identificador de serviço. Use mys_national_id.
full_name	string	Sim	Nome completo.
date_of_birth	string	Sim	Data de nascimento.
national_id	string	Sim	Identidade nacional.
address	string	Não	Morada (verificação cruzada opcional).
phone	string	Não	Telefone (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=MYS" \
  -F "services=mys_national_id" \
  -F "full_name=John Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "national_id=1111111"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "MYS",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "mys_national_id",
      "service_name": "Malaysia National ID",
      "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. É cobrado apenas por 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 uma meta trimestral de 99,9% de tempo de atividade.
• 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 Malásia.
• Cripto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autoritária.
• 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 autoritários, não apenas um formulário auto-reportado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores da Malásia com um rasto auditável.

Como integrar com a Didit

Pode executar a Verificação de Identidade Nacional da Malásia 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 Malásia → Verificação de Identidade Nacional da Malásia 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=mys_national_id. 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 a verificação de Identidade Nacional da Malásia confirma?

Valida os dados submetidos contra o registo oficial de identidade do governo do país e retorna um resultado de correspondência normalizado, para que saiba se a identidade nacional existe na fonte autoritária e quais os campos que corresponderam.

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

Não será 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 geralmente 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 ligá-lo a um fluxo de trabalho sem código na Consola Empresarial.

Pronto para começar?

Valide hoje a sua primeira identidade nacional da Malásia.

• Leia a referência da API: Verificação de Identidade Nacional da Malásia
• Veja 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.