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

# Verifica telefonica API: OTP via SMS e segnali di rischio

> Didit: verifica telefonica con OTP via SMS, rilevamento operatore, numeri virtuali e usa e getta. Tariffa operatore + $0.02, senza contratti.

L'API di verifica telefonica offre un flusso in due passaggi: inviare un codice monouso a un numero di telefono e verificare quindi il codice. Il sistema rileva il tipo di operatore, i numeri virtuali e i telefoni usa e getta.

## Endpoint

> [card] [Invia codice telefonico](https://docs.didit.me/it/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/`: invia via SMS un codice di verifica monouso.

> [card] [Verifica codice telefonico](https://docs.didit.me/it/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/`: verifica il codice e recupera i dati di rischio del telefono.

> [card] [Valuta il rischio telefonico](https://docs.didit.me/it/standalone-apis/phone-risk.md)
>
> `POST /v3/phone/risk/`: assegna un punteggio al rischio relativo all'operatore, al tipo di linea, alla portabilità e alla frode, senza inviare un OTP.

## Come funziona

1. Chiama **Invia codice telefonico** con il numero di telefono in formato E.164 (ad esempio `+14155552671`)
2. L'utente riceve un codice via SMS (valido per 5 minuti)
3. Chiama **Verifica codice telefonico** con il numero di telefono e il codice
4. Ricevi il risultato della verifica e i segnali di rischio (tipo di operatore, rilevamento del numero virtuale)

## Canali di invio

Didit supporta più canali, a seconda della disponibilità nel paese:

| Canale | Descrizione |
| - | - |
| SMS | Messaggio di testo standard |
| WhatsApp | Messaggistica WhatsApp |
| Telegram | Messaggistica Telegram |
| RCS | Rich Communication Services |
| Viber | Messaggistica Viber |

## Segnali di rischio

| Segnale | Descrizione |
| - | - |
| `is_disposable` | Numero di telefono temporaneo o usa e getta |
| `is_virtual` | Numero VoIP o virtuale |
| `carrier.type` | `mobile`, `landline` o `voip` |

Per la struttura completa della risposta, consulta il [Report di verifica telefonica](https://docs.didit.me/it/core-technology/phone-verification/overview.md).

## Interruzioni del provider

Se il provider telefonico a monte non risponde a una richiesta di invio o di verifica, entrambi gli endpoint restituiscono `502` con `code: "phone_provider_unavailable"` invece di un errore generico. È sicuro riprovare, la richiesta non viene addebitata e non consuma un tentativo dal limite orario per numero. Basa la logica sul valore di `code` anziché analizzare il messaggio in `detail`, perché il testo del messaggio non è un contratto stabile.


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