Endpoints
Envia el codi de telèfon
POST /v3/phone/send/ — Envia un codi de verificació d’un sol ús per SMS.Verifica el codi de telèfon
POST /v3/phone/check/ — Verifica el codi i recupera les dades de risc del telèfon.Puntua el risc del telèfon
POST /v3/phone/risk/ — Puntua el risc de l’operador, el tipus de línia, la portabilitat i el frau sense enviar cap OTP.Com funciona
- Crida Envia el codi de telèfon amb el número de telèfon en format E.164 (per exemple,
+14155552671) - L’usuari rep un codi per SMS (vàlid durant 5 minuts)
- Crida Verifica el codi de telèfon amb el número de telèfon i el codi
- Rep el resultat de la verificació i els senyals de risc (tipus d’operador, detecció de números virtuals)
Canals de lliurament
Didit admet diversos canals segons la disponibilitat a cada país:Senyals de risc
Per a l’estructura completa de la resposta, consulta l’Informe de verificació de telèfon.
Interrupcions del proveïdor
Si el proveïdor de telefonia aigües amunt no respon a una sol·licitud d’enviament o de verificació, tots dos endpoints retornen502 amb code: "phone_provider_unavailable" en lloc d’un error genèric. Es pot reintentar sense risc, no es factura i no consumeix un intent del límit horari per número. Basa la lògica en code i no analitzis el text de detail, perquè el contingut del missatge no és un contracte estable.