API de vérification de la joignabilité en Afrique du Sud (FR-1)

L'intégration d'utilisateurs en Afrique du Sud implique de confirmer qu'ils sont bien ceux qu'ils prétendent être. Elle renvoie les numéros de téléphone, e-mails et adresses connus associés à une personne sud-africaine. Un document ou un détail saisi prouve seulement que les données existent — pas qu'elles sont authentiques ou qu'elles appartiennent à la personne devant vous. La vérification de la joignabilité en Afrique du Sud comble cette lacune en comparant les données avec celles des opérateurs de réseaux mobiles. Ce guide explique ce que fait la vérification, les détails techniques exacts et comment l'intégrer en quelques minutes.

Points clés à retenir :

• Ce qu'elle vérifie — La vérification de la joignabilité en Afrique du Sud valide la propriété du numéro de téléphone par rapport aux données des opérateurs de réseaux mobiles.
• Ce que vous obtenez — un match_type normalisé ainsi que des résultats au niveau des champs que vous pouvez directement intégrer à votre logique d'approbation / révision / rejet.
• Pourquoi c'est important — Confirmer qu'un numéro de téléphone appartient à la personne déclarée bloque les prises de contrôle de compte et la fraude basée sur les cartes SIM avant qu'elles ne commencent.
• Comment l'utiliser — une seule requête POST vers l'endpoint de validation de base de données de Didit, ou un module de workflow sans code. 0,35 $ par requête concluante, résultats en quelques secondes.

Ce que la vérification de la joignabilité en Afrique du Sud valide

Elle renvoie les numéros de téléphone, e-mails et adresses connus associés à une personne sud-africaine. Didit l'expose via un seul endpoint afin que vous puissiez vérifier les données soumises par rapport aux données des opérateurs de réseaux mobiles et recevoir un résultat structuré et normalisé — pas un dump de registre brut que vous auriez à analyser vous-même.

Une réponse conclusive renvoie le source_data correspondant et un bloc validation par champ, afin que votre moteur de risque obtienne un verdict clair et lisible par machine.

Pourquoi c'est important

Confirmer qu'un numéro de téléphone appartient à la personne déclarée bloque les prises de contrôle de compte et la fraude basée sur les cartes SIM avant qu'elles ne commencent.

Pour les entreprises réglementées en Afrique du Sud — fintechs, plateformes crypto, prêteurs, marketplaces et opérateurs de jeux — la vérification par rapport à une source faisant autorité produit un enregistrement défendable et auditable que l'identité a été confirmée à la source, et non pas simplement capturée à partir d'un formulaire ou d'une photo.

Détails techniques

Didit expose ce service via l'endpoint unifié de validation de base de données. Il s'agit d'une seule requête POST — aucun SDK n'est requis.

Endpoint

POST /v3/database-validation/

Paramètres de la requête

Paramètre	Type	Requis	Description
issuing_state	string	Yes	Code pays ISO 3166-1 alpha-3. Utilisez ZAF.
services	string	Yes	Identifiant du service. Utilisez zaf_contactability.
national_id	string	Yes	Identifiant national.

Exemple de requête

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

Exemple de réponse (correspondance concluante)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_contactability",
      "service_name": "South Africa - Contactability Lookup",
      "source_data": {
        "contact_email": "alex.sample@example.com",
        "contact_phone_numbers": "+15550101000",
        "date_of_birth": "1990-01-01",
        "deceased": "sample_value",
        "first_name": "John",
        "gender": "M",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "phone_history_count": "+15550101000"
      },
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

Performance et facturation

• Latence : généralement quelques secondes.
• Coût : 0,35 $ par requête concluante. Vous n'êtes facturé que sur les résultats concluants — pas de frais pour les indisponibilités de source, les champs manquants ou les rejets avant la source.
• Fiabilité : fonctionne sur l'infrastructure Didit avec un objectif de disponibilité trimestriel de 99,9 %.
• Consentement : ce service nécessite un consentement documenté de l'utilisateur final. Capturez-le et stockez-le avant d'appeler l'endpoint.

Cas d'utilisation

• Fintech et néobanques — confirmez un titulaire de compte réel et vérifiable avant d'ouvrir un portefeuille ou d'accorder un crédit en Afrique du Sud.
• Crypto et Web3 — respectez les exigences d'intégration des VASP avec une preuve d'identité provenant d'une source faisant autorité.
• Prêts — réduisez la fraude d'identité synthétique et de première partie avec des données vérifiées à la source.
• Marketplaces et plateformes de services — vérifiez les utilisateurs par rapport à des données faisant autorité, et non pas seulement à un formulaire auto-déclaré.
• iGaming — satisfaites les vérifications d'identité et d'éligibilité pour les joueurs sud-africains avec une trace auditable.

Comment s'intégrer à Didit

Vous pouvez effectuer la vérification de la joignabilité en Afrique du Sud de deux manières :

1. Workflow sans code. Dans la console Didit Business, ouvrez le Workflow Builder, ajoutez le module Database Validation, sélectionnez South Africa → South Africa Contactability Lookup Verification, et activez-le. Les utilisateurs correspondants sont acheminés automatiquement — aucune ingénierie requise.
2. API directe. Appelez l'endpoint /v3/database-validation/ indiqué ci-dessus avec services=zaf_contactability. Lisez le match_type et le bloc validation par champ pour piloter votre logique d'approbation / révision / rejet.

Chaque compte Didit inclut 500 vérifications gratuites par mois, afin que vous puissiez tester le flux complet de bout en bout avant de payer une seule requête.

Foire aux questions

Que confirme la vérification de la joignabilité en Afrique du Sud ?

Elle valide les données soumises par rapport aux données des opérateurs de réseaux mobiles et renvoie un résultat de correspondance normalisé, vous permettant ainsi de savoir si la propriété du numéro de téléphone existe à la source faisant autorité et quels champs correspondent.

Que se passe-t-il si la source est temporairement indisponible ?

Vous n'êtes pas facturé. La facturation s'applique uniquement aux résultats concluants — les indisponibilités de source, les champs manquants et les rejets avant la source sont gratuits.

Quelle est la rapidité de la vérification ?

La validation de base de données est généralement renvoyée en quelques secondes, elle s'intègre donc dans un flux d'intégration en temps réel.

Ai-je besoin d'un SDK ?

Non. La vérification est une seule requête HTTPS POST vers un endpoint. Vous pouvez également l'intégrer à un workflow sans code dans la console Business.

Prêt à commencer ?

Validez la propriété de votre premier numéro de téléphone sud-africain dès aujourd'hui.

• Lisez la référence de l'API : Vérification de la joignabilité en Afrique du Sud
• Voir toutes les validations de base de données : Tarifs et couverture de la validation de base de données
• Commencez à construire : Créez un compte Didit gratuit — 500 vérifications par mois, gratuites.