API de Verificação de Arquivo de Refugiado na África do Sul

Integrar usuários na África do Sul significa confirmar que eles são quem afirmam ser. Este serviço verifica um número de arquivo de refugiado contra o registro de refugiados do Departamento de Assuntos Internos da África do Sul. Um documento ou um dado digitado apenas prova que a informação existe — não que seja genuína ou pertença à pessoa à sua frente. A Verificação de Arquivo de Refugiado 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 Arquivo de Refugiado da África do Sul valida registros governamentais contra fontes de dados governamentais autorizadas.
• O que você recebe — um match_type normalizado, além de resultados em nível de campo que você pode direcionar diretamente para lógicas de aprovação / revisão / rejeição.
• Por que é importante — Registros governamentais são a fonte autorizada mais forte para confirmar que uma pessoa existe com a identidade declarada.
• Como usar — um único POST para o endpoint de validação de banco de dados da Didit. US$1,10 por consulta conclusiva, resultados em segundos.

O que a Verificação de Arquivo de Refugiado da África do Sul valida

Verifica um número de arquivo de refugiado contra o registro de refugiados do Departamento de Assuntos Internos da África do Sul. A Didit o expõe através de um único endpoint para que você possa verificar os dados enviados contra fontes de dados governamentais autorizadas 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 validation por campo, para que seu motor de risco obtenha um veredicto claro e legível por máquina.

Por que é importante

Registros governamentais são a fonte autorizada mais forte para confirmar que uma pessoa existe com a identidade declarada.

Para empresas reguladas na África do Sul — fintechs, plataformas de criptomoedas, credores, marketplaces e operadores de jogos — verificar contra uma fonte autorizada 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 da requisição

Parâmetro	Tipo	Obrigatório	Descrição
issuing_state	string	Sim	Código de país ISO 3166-1 alpha-3. Use ZAF.
services	string	Sim	Identificador de serviço. Use zaf_refugee.
refugee_file_number	string	Sim	Número do arquivo de refugiado.
phone_number	string	Não	Número de telefone (verificação cruzada opcional).
email	string	Não	E-mail (verificação cruzada opcional).

Exemplo de requisição

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_refugee" \
  -F "refugee_file_number=1111111"

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_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

Desempenho e faturamento

• Latência: tipicamente alguns segundos.
• Custo: US$1,10 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: roda 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 Á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.
• Marketplaces e plataformas de 'gig economy' — verifique usuários contra dados autorizados, não apenas um formulário auto-declarado.
• iGaming — satisfaça as verificações de identidade e elegibilidade para jogadores da África do Sul com um registro auditável.

Como integrar com a Didit

Você pode executar a Verificação de Arquivo de Refugiado da África do Sul de duas maneiras:

1. Apenas API direta. Este serviço é executado através da API, e não do construtor de fluxo de trabalho sem código.
2. API direta. Chame o endpoint /v3/database-validation/ mostrado acima com services=zaf_refugee. Leia o 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 o fluxo completo de ponta a ponta antes de pagar por uma única consulta.

Perguntas frequentes

O que a Verificação de Arquivo de Refugiado da África do Sul confirma?

Ela valida os dados enviados contra fontes de dados governamentais autorizadas e retorna um resultado de correspondência normalizado, para que você saiba se os registros governamentais existem na fonte autorizada 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, por isso 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.

Pronto para começar?

Valide seus primeiros registros governamentais da África do Sul hoje.

• Leia a referência da API: Verificação de Arquivo de Refugiado da África do Sul
• 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.