> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Vérification du téléphone : API, OTP SMS et risque

> Didit vérifie les téléphones par OTP SMS en deux étapes, avec détection des numéros virtuels et jetables. Prix opérateur + $0.02, sans contrat.

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

> [card] [Envoyer un code téléphonique](https://docs.didit.me/fr/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/` : envoyer un code de vérification à usage unique par SMS.

> [card] [Vérifier le code téléphonique](https://docs.didit.me/fr/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/` : vérifier le code et récupérer les données de risque du téléphone.

> [card] [Évaluer le risque lié au téléphone](https://docs.didit.me/fr/standalone-apis/phone-risk.md)
>
> `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 :

| Canal | Description |
| - | - |
| SMS | Message texte standard |
| WhatsApp | Messagerie WhatsApp |
| Telegram | Messagerie Telegram |
| RCS | Rich Communication Services |
| Viber | Messagerie Viber |

## Signaux de risque

| Signal | Description |
| - | - |
| `is_disposable` | Numéro de téléphone temporaire ou jetable |
| `is_virtual` | Numéro VoIP ou virtuel |
| `carrier.type` | `mobile`, `landline` ou `voip` |

Pour la structure complète de la réponse, voir [Rapport de vérification du téléphone](https://docs.didit.me/fr/core-technology/phone-verification/overview.md).

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.