API de Verificação de Impressões Digitais DHA da África do Sul

Integrar utilizadores na África do Sul significa confirmar que são quem dizem ser. Verifica as imagens de impressões digitais fornecidas contra o registo de impressões digitais do Departamento de Assuntos Internos. 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 de Impressões Digitais DHA da África do Sul preenche essa lacuna verificando os dados contra fontes de dados governamentais 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 de Impressões Digitais DHA da África do Sul valida registos governamentais contra fontes de dados governamentais autorizadas.
• O que obtém de volta — 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 — Os registos detidos pelo governo são a fonte autorizada mais forte para confirmar que uma pessoa existe na identidade declarada.
• Como usá-lo — um POST para o endpoint de validação de base de dados da Didit. 1,10$ por consulta conclusiva, resultados em segundos.

O que a Verificação de Impressões Digitais DHA da África do Sul valida

Verifica as imagens de impressões digitais fornecidas contra o registo de impressões digitais do Departamento de Assuntos Internos. A Didit expõe-no através de um único endpoint para que possa verificar os dados submetidos contra fontes de dados governamentais autorizadas e receber um resultado estruturado e normalizado — não um despejo bruto do registo que tenha de analisar por si 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

Os registos detidos pelo governo são a fonte autorizada mais forte para confirmar que uma pessoa existe na identidade declarada.

Para empresas reguladas na África do Sul — 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 fonte, e 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 — 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 do país ISO 3166-1 alfa-3. Use ZAF.
services	string	Sim	Identificador do serviço. Use zaf_dha_fingerprint_match.
national_id	string	Sim	ID nacional.
right_thumb	string	Sim	Polegar direito.
left_thumb	string	Sim	Polegar esquerdo.

Exemplo de pedido

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_dha_fingerprint_match" \
  -F "national_id=1111111" \
  -F "right_thumb=sample_value" \
  -F "left_thumb=sample_value"

Exemplo de resposta (correspondência conclusiva)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_dha_fingerprint_match",
      "service_name": "South Africa - DHA Fingerprint Match",
      "source_data": {
        "identification_number": "SAMPLE-ID-12345"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

Desempenho e faturação

• Latência: tipicamente alguns segundos.
• Custo: 1,10$ por consulta conclusiva. É faturado apenas por resultados conclusivos — sem custo por tempo de inatividade da fonte, campos em falta ou rejeições pré-fonte.
• Fiabilidade: funciona na infraestrutura da Didit com um objetivo de tempo de atividade trimestral de 99,9%.
• Consentimento: este serviço requer consentimento documentado do utilizador final. Capture-o 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 África do Sul.
• Cripto e Web3 — cumpra os requisitos de integração VASP com prova de identidade de fonte autorizada.
• 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 autorizados, não apenas um formulário auto-reportado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores da África do Sul com um rasto auditável.

Como integrar com a Didit

Pode executar a Verificação de Impressões Digitais DHA da África do Sul de duas maneiras:

1. Apenas API direta. Este serviço funciona através da API em vez do construtor de fluxo de trabalho sem código.
2. API direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=zaf_dha_fingerprint_match. 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 confirma a Verificação de Impressões Digitais DHA da África do Sul?

Valida os dados submetidos contra fontes de dados governamentais autorizadas e retorna um resultado de correspondência normalizado, para que saiba se os registos governamentais 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 geralmente 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.

Pronto para começar?

Valide os seus primeiros registos governamentais da África do Sul hoje.

• Leia a referência da API: Verificação de Impressões Digitais DHA da África do Sul
• 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, grátis.