Primeros pasos
Integración / SDKs
Verificación de usuarios
Verificación de empresas
Monitorización de transacciones
Registro de cambiosEndpoints
Enviar código al teléfono
POST /v3/phone/send/: envía un código de verificación de un solo uso por SMS.Comprobar código del teléfono
POST /v3/phone/check/: verifica el código y obtiene los datos de riesgo del teléfono.Evaluar riesgo telefónico
POST /v3/phone/risk/: puntúa el riesgo de operador, tipo de línea, portabilidad y fraude sin enviar un OTP.Cómo funciona
- Llama al endpoint Send Phone Code con el número de teléfono en formato E.164 (por ejemplo,
+14155552671) - El usuario recibe un código por SMS (válido durante 5 minutos)
- Llama al endpoint Check Phone Code con el número de teléfono y el código
- Recibe el resultado de la verificación junto con las señales de riesgo (tipo de operador, detección de números virtuales)
Canales de entrega
Didit admite varios canales según la disponibilidad en cada país:Señales de riesgo
Para ver la estructura completa de la respuesta, consulta el informe de verificación de teléfono.
Caídas del proveedor
Si el proveedor telefónico externo no responde a una solicitud de envío o de comprobación, ambos endpoints devuelven502 con code: "phone_provider_unavailable" en lugar de un error genérico. Puedes reintentar la solicitud sin riesgo: no se factura y no consume ningún intento del límite por hora de cada número. Basa la lógica en code en lugar de analizar el mensaje de detail, ya que el texto del mensaje no es un contrato estable.