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

# Verificació de telèfon: API OTP per SMS i senyals de risc

> Didit: verificació de telèfon en 2 passos amb OTP per SMS, detecció d'operador i número virtual. Preu de l'operador + $0.02 per ús, sense contractes.

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

> [card] [Envia el codi de telèfon](https://docs.didit.me/ca/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/` — Envia un codi de verificació d'un sol ús per SMS.

> [card] [Verifica el codi de telèfon](https://docs.didit.me/ca/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/` — Verifica el codi i recupera les dades de risc del telèfon.

> [card] [Puntua el risc del telèfon](https://docs.didit.me/ca/standalone-apis/phone-risk.md)
>
> `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:

| Canal | Descripció |
| - | - |
| SMS | Missatge de text estàndard |
| WhatsApp | Missatgeria de WhatsApp |
| Telegram | Missatgeria de Telegram |
| RCS | Rich Communication Services |
| Viber | Missatgeria de Viber |

## Senyals de risc

| Senyal | Descripció |
| - | - |
| `is_disposable` | Número de telèfon temporal o d'un sol ús |
| `is_virtual` | Número VoIP o virtual |
| `carrier.type` | `mobile`, `landline` o `voip` |

Per a l'estructura completa de la resposta, consulta l'[Informe de verificació de telèfon](https://docs.didit.me/ca/core-technology/phone-verification/overview.md).

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


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