Saltar al contingut principal
L’API de verificació de telèfon ofereix un flux de dos passos: envia un codi d’un sol ús a un número de telèfon i després verifica el codi. El sistema detecta el tipus d’operador, els números virtuals i els telèfons d’un sol ús.

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

  1. Crida Envia el codi de telèfon amb el número de telèfon en format E.164 (per exemple, +14155552671)
  2. L’usuari rep un codi per SMS (vàlid durant 5 minuts)
  3. Crida Verifica el codi de telèfon amb el número de telèfon i el codi
  4. 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 retornen 502 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.
Darrera modificació el 7 de novembre del 2026