Vai al contenuto principale
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

Invia codice telefonico

POST /v3/phone/send/: invia via SMS un codice di verifica monouso.

Verifica codice telefonico

POST /v3/phone/check/: verifica il codice e recupera i dati di rischio del telefono.

Valuta il rischio telefonico

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:

​
Segnali di rischio

Per la struttura completa della risposta, consulta il Report di verifica telefonica.

​
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.
Ultima modifica il 7 novembre 2026