Passer au contenu principal
L’API de vérification du téléphone propose un flux en deux étapes : envoyer un code à usage unique à un numéro de téléphone, puis vérifier ce code. Le système détecte le type d’opérateur, les numéros virtuels et les téléphones jetables.

​
Endpoints

Envoyer un code téléphonique

POST /v3/phone/send/ : envoyer un code de vérification à usage unique par SMS.

Vérifier le code téléphonique

POST /v3/phone/check/ : vérifier le code et récupérer les données de risque du téléphone.

Évaluer le risque lié au téléphone

POST /v3/phone/risk/ : noter l’opérateur, le type de ligne, la portabilité et le risque de fraude, sans envoyer d’OTP.

​
Fonctionnement

  1. Appelez Envoyer un code téléphonique avec le numéro de téléphone au format E.164 (par exemple +14155552671)
  2. L’utilisateur reçoit un code par SMS (valide pendant 5 minutes)
  3. Appelez Vérifier le code téléphonique avec le numéro de téléphone et le code
  4. Recevez le résultat de la vérification ainsi que les signaux de risque (type d’opérateur, détection de numéro virtuel)

​
Canaux d’envoi

Didit prend en charge plusieurs canaux selon la disponibilité dans chaque pays :

​
Signaux de risque

Pour la structure complète de la réponse, voir Rapport de vérification du téléphone.

​
Indisponibilités du fournisseur

Si le fournisseur de téléphonie en amont ne répond pas à une requête d’envoi ou de vérification, les deux endpoints renvoient 502 avec code: "phone_provider_unavailable" au lieu d’une erreur générique. Vous pouvez réessayer cette requête sans risque : elle n’est pas facturée et ne consomme aucune tentative du plafond horaire par numéro. Basez votre logique sur code plutôt que d’analyser le message detail, car le texte de ce message n’est pas un contrat stable.
Dernière modification le 7 novembre 2026