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

# API de verificação de telefone: SMS OTP e sinais de risco

> OTP por SMS da Didit em duas etapas, com detecção de operadora, número virtual e descartável. Preço da operadora + $0.02, sem contrato.

A API de verificação de telefone oferece um fluxo em duas etapas: enviar um código de uso único para um número de telefone e, em seguida, verificar o código. O sistema detecta o tipo de operadora, números virtuais e telefones descartáveis.

## Endpoints

> [card] [Enviar código para telefone](https://docs.didit.me/pt-br/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/`: envia um código de verificação de uso único por SMS.

> [card] [Verificar código do telefone](https://docs.didit.me/pt-br/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/`: verifica o código e obtém os dados de risco do telefone.

> [card] [Pontuar risco do telefone](https://docs.didit.me/pt-br/standalone-apis/phone-risk.md)
>
> `POST /v3/phone/risk/`: pontua a operadora, o tipo de linha, a portabilidade e o risco de fraude sem enviar um OTP.

## Como funciona

1. Chame **Send Phone Code** com o número de telefone no formato E.164 (por exemplo, `+14155552671`)
2. O usuário recebe um código por SMS (válido por 5 minutos)
3. Chame **Check Phone Code** com o número de telefone e o código
4. Receba o resultado da verificação junto com os sinais de risco (tipo de operadora, detecção de número virtual)

## Canais de entrega

A Didit oferece vários canais, conforme a disponibilidade em cada país:

| Canal | Descrição |
| - | - |
| SMS | Mensagem de texto padrão |
| WhatsApp | Mensagens pelo WhatsApp |
| Telegram | Mensagens pelo Telegram |
| RCS | Rich Communication Services |
| Viber | Mensagens pelo Viber |

## Sinais de risco

| Sinal | Descrição |
| - | - |
| `is_disposable` | Número de telefone temporário/descartável |
| `is_virtual` | Número VoIP ou virtual |
| `carrier.type` | `mobile`, `landline` ou `voip` |

Para ver a estrutura completa da resposta, consulte o [Relatório de verificação de telefone](https://docs.didit.me/pt-br/core-technology/phone-verification/overview.md).

## Indisponibilidade do provedor

Se o provedor de telefonia upstream não responder a uma requisição de envio ou de verificação, os dois endpoints retornam `502` com `code: "phone_provider_unavailable"` em vez de um erro genérico. É seguro tentar novamente: a requisição não é cobrada e não consome uma tentativa do limite por hora por número. Baseie a lógica de ramificação em `code` em vez de analisar a mensagem de `detail`, pois o texto da mensagem não é um contrato estável.


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