Verificação de carteira de motorista na África do Sul API

​

Cobertura

• Cobertura: —
• País: África do Sul
• ID do serviço: zaf_drivers_license
• Domínio de dados: Identidade
• Categoria: DriverLicence

​

Entradas

• Entradas obrigatórias: national_id, last_name, initials, licence_number
• Entradas opcionais: first_name, date_of_birth, vendor_data
• Consentimento: Não obrigatório
• Disponibilidade no fluxo de verificação (workflow): Disponível no fluxo com mapeamento de campos
• Cobertura: —
• Preço: $0.80 por consulta bem-sucedida

​

Parâmetros do corpo

​

Regras de entrada e notas de validação

• Envie os campos listados acima exatamente como foram capturados do usuário ou do documento.
• A Didit valida os campos obrigatórios antes de chamar o banco de dados. Requisições rejeitadas antes da consulta à fonte não são cobradas.

​

Como chamar

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_drivers_license" \
  -F "vendor_data=user-1234" \
  -F "national_id=SAMPLE-NID-12345" \
  -F "last_name=Doe" \
  -F "initials=JD" \
  -F "licence_number=LIC123456"

Toda chamada bem-sucedida retorna HTTP 200. O campo outcome_code informa o que realmente aconteceu, distinguindo, por exemplo, uma divergência biométrica real (BIOMETRIC_NO_MATCH) de uma selfie que não pôde ser lida (BIOMETRIC_IMAGE_UNUSABLE). O status exibido é o status padrão do recurso; as ações de Correspondência parcial / Sem correspondência que você configurou podem sobrescrevê-lo.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "expiration_date": "2030-05-31",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "vehicle_codes": "EB"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": null,
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "licence_valid": false
      },
      "validation": {}
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "ZAF",
  "match_type": null,
  "validations": [
    {
      "outcome_code": "INCONCLUSIVE",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "licence_valid": true
      },
      "validation": {}
    }
  ]
}

​

Dados retornados

• expiration_date
• first_name
• identification_number
• last_name
• licence_valid
• vehicle_codes

​

Preços e SLAs

• Preço por chamada: $0.80 USD.
• Faturamento: por consulta bem-sucedida. Você não é cobrado quando o registro está inacessível, quando faltam campos obrigatórios ou quando a requisição é rejeitada antes de chegar à fonte.
• Latência: p95 típico < 2 s.
• Disponibilidade: 99.9% por trimestre do lado da Didit; a disponibilidade da fonte varia conforme o país e o conjunto de dados.

​

O que cada resultado significa

• MATCH - o registro retornou um registro de licença para este número de licença, e os dados que você enviou corresponderam a ele. source_data traz o registro: identification_number (o número da licença), first_name e last_name, vehicle_codes (as categorias da licença, por exemplo EB, C1) e expiration_date (a data de validade do cartão da licença).
• INCONCLUSIVE - o registro aceitou a consulta, mas não retornou nenhum registro de licença, então não havia nada com que comparar os dados enviados. source_data.licence_valid é true, validation fica vazio e match_type é null. Nada sobre a licença é confirmado, por isso a verificação é enviada para revisão. Isso vale também quando outro serviço na mesma requisição, como a verificação da identidade nacional, encontrou correspondência para a pessoa, porque isso confirma a pessoa, e não a licença.
• NO_MATCH - o registro buscou a licença e a informou como não válida (source_data.licence_valid: false). A ação que você configurou para não correspondência é aplicada.
• REGISTRY_ERROR - o registro não executou a busca, então nada foi apurado sobre a licença. A verificação é enviada para revisão e não é cobrada.

​

Continue lendo

• Visão geral da Validação de banco de dados da África do Sul
• Visão geral da Validação de banco de dados
• Códigos de resultado