Saltar para o conteúdo principal
A API de Verificação de telefone fornece um fluxo de dois passos: envia um código de utilização única para um número de telefone e, depois, verifica o código. O sistema deteta o tipo de operadora, os números virtuais e os telefones descartáveis.

Endpoints

Enviar código de telefone

POST /v3/phone/send/: envia um código de verificação de utilização única por SMS.

Verificar código de telefone

POST /v3/phone/check/: verifica o código e obtém os dados de risco do telefone.

Calcular pontuação de risco do telefone

POST /v3/phone/risk/: calcula o risco da operadora, do tipo de linha, da portabilidade e de fraude, sem enviar um OTP.

Como funciona

  1. Chame Enviar código de telefone com o número de telefone no formato E.164 (por exemplo, +14155552671)
  2. O utilizador recebe um código por SMS (válido durante 5 minutos)
  3. Chame Verificar código de telefone com o número de telefone e o código
  4. Receba o resultado da verificação e os sinais de risco (tipo de operadora, deteção de número virtual)

Canais de entrega

A Didit suporta vários canais, consoante a disponibilidade no país:

Sinais de risco

Para a estrutura completa da resposta, consulte o Relatório de verificação de telefone.

Falhas do fornecedor

Se o fornecedor de telefonia a montante não responder a um pedido de envio ou de verificação, ambos os endpoints devolvem 502 com code: "phone_provider_unavailable", em vez de um erro genérico. Pode repetir o pedido sem risco, não é faturado e não consome uma tentativa do limite horário por número. Use code para decidir o fluxo, em vez de analisar a mensagem detail, uma vez que o texto da mensagem não é um contrato estável.
Última modificação em 7 de novembro de 2026