Vérification du permis de conduire Afrique du Sud - API

​

Couverture

• Couverture : —
• Pays : Afrique du Sud
• Identifiant du service : zaf_drivers_license
• Domaine de données : Identité
• Catégorie : DriverLicence

​

Entrées

• Entrées obligatoires : national_id, last_name, initials, licence_number
• Entrées facultatives : first_name, date_of_birth, vendor_data
• Consentement : Non requis
• Disponibilité dans le workflow : Disponible dans un workflow avec mappage des champs
• Couverture : —
• Prix : $0.80 par requête réussie

​

Paramètres du corps de requête

​

Règles de saisie et notes de validation

• Envoyez les champs listés ci-dessus exactement tels qu’ils ont été saisis par l’utilisateur ou figurent sur le document.
• Didit valide les champs obligatoires avant d’appeler la base de données. Les requêtes rejetées avant la recherche dans la source ne sont pas facturées.

​

Comment l’appeler

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"

Chaque appel réussi renvoie le code HTTP 200. Le champ outcome_code indique ce qui s’est réellement passé, en distinguant par exemple une véritable non-correspondance biométrique (BIOMETRIC_NO_MATCH) d’un selfie illisible (BIOMETRIC_IMAGE_UNUSABLE). Le status affiché est le statut par défaut de la fonctionnalité ; vos actions Partial Match / No Match configurées peuvent le remplacer.

{
  "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": {}
    }
  ]
}

​

Données retournées

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

​

Tarifs et SLA

• Prix par appel : $0.80 USD.
• Facturation : par requête réussie. Vous n’êtes pas facturé lorsque le registre est injoignable, lorsque des champs obligatoires manquent, ou lorsque la requête est rejetée avant d’atteindre la source.
• Latence : p95 typique inférieur à 2 s.
• Disponibilité : 99.9% par trimestre côté Didit ; la disponibilité de la source en aval varie selon le pays et le jeu de données.

​

Ce que signifie chaque résultat

• MATCH - le registre a renvoyé une fiche de permis pour ce numéro, et les informations que vous avez soumises correspondent à cette fiche. source_data contient la fiche : identification_number (le numéro de permis), first_name et last_name, vehicle_codes (les catégories de permis, par exemple EB, C1) et expiration_date (la date d’expiration de la carte de permis).
• INCONCLUSIVE - le registre a accepté la requête mais n’a renvoyé aucune fiche de permis, il n’y avait donc rien à comparer avec les informations soumises. source_data.licence_valid vaut true, validation est vide et match_type vaut null. Rien n’est confirmé concernant le permis : la vérification est donc envoyée en examen manuel, y compris lorsqu’un autre service de la même requête, comme la vérification de l’identité nationale, a établi une correspondance avec la personne, car cela confirme la personne et non le permis.
• NO_MATCH - le registre a recherché le permis et l’a signalé comme non valide (source_data.licence_valid: false). Votre action en cas d’absence de correspondance s’applique.
• REGISTRY_ERROR - le registre n’a pas effectué la recherche, rien n’a donc été établi concernant le permis. La vérification est envoyée en examen manuel et n’est pas facturée.

​

Pour aller plus loin

• Vue d’ensemble de la validation en base de données pour l’Afrique du Sud
• Vue d’ensemble de la validation en base de données
• Codes de résultat