Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alteraçõesEndpoints
Enviar código para telefone
POST /v3/phone/send/: envia um código de verificação de uso único por SMS.Verificar código do telefone
POST /v3/phone/check/: verifica o código e obtém os dados de risco do telefone.Pontuar risco do telefone
POST /v3/phone/risk/: pontua a operadora, o tipo de linha, a portabilidade e o risco de fraude sem enviar um OTP.Como funciona
- Chame Send Phone Code com o número de telefone no formato E.164 (por exemplo,
+14155552671) - O usuário recebe um código por SMS (válido por 5 minutos)
- Chame Check Phone Code com o número de telefone e o código
- 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:Sinais de risco
Para ver a estrutura completa da resposta, consulte o Relatório de verificação de telefone.
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 retornam502 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.